Skip to content
English
  • There are no suggestions because the search field is empty.

PSOhub API: Companies

Learn how to retrieve and create companies in PSOhub via the API

Published: 1 June 2026

Audience

  • Admin

Objective

This reference article covers the PSOhub API endpoints for retrieving and creating companies. Use these endpoints to search for existing companies and create new ones programmatically within your PSOhub organization.

Prerequisites

Eligible access
        You must have Admin user access in PSOhub.

API enabled
        You must have API access enabled for your PSOhub account.

Get All Companies

Use this endpoint to retrieve a list of companies from your PSOhub organization:

Endpoint

 
 
GET https://www.psohubapp.com/rest/psohubapi/v1/companies

Use the limit parameter to control the number of records returned. If not specified, the API returns 50 companies by default.

Example response

 
 

json

[   {     "CompanyName": "Demo Company",     "CompanyID": 14073748835533011,     "Address": "15 Stadionstraat",     "PostalCode": "4815NC",     "City": "Breda",     "Country": "Netherlands",     "PhoneNumber": "+31 85 800 0045",     "CountryCode": "NL"   } ]

Find a Company

Use the name or companyid parameter to search for a specific company.

Endpoint

 
 
GET https://www.psohubapp.com/rest/psohubapi/v1/companies?name=tesla

The response returns all records where the company name contains the search value.

Search parameters

Parameter Type Description
name String Returns all companies whose name contains the search value.
companyid Integer/Long Returns the company matching the specified PSOhub company ID.

Create or Update a Company

Use this endpoint to create a new company or update an existing one.

Endpoint

 
 
POST  https://www.psohubapp.com/rest/psohubapi/v1/company PATCH https://www.psohubapp.com/rest/psohubapi/v1/company

⚠️ Important: PSOhub does not check for duplicate company names. Multiple companies          with the same name can exist within your organization. Always verify that a company            does not already exist before creating a new one.

Request fields

Name Required Type Description
Name Yes String The name of the company.
CompanyRegistrationNumber No String The company registration number (for example, KvK for Dutch companies).
TaxNumber No String The tax number for invoicing purposes (for example, BTW for Dutch companies).
PhoneNumber No String The phone number of the company.
Street No String The street name and house number.
PostalCode No String The postal code.
City No String The city.
Country No String The country name.
CountryCode No String The ISO country code (for example, NL). Note: this does not automatically populate the Country field.
ExternalID No String The identifier for this company from your external application.
CompanyID Yes (update only) Integer/Long The PSOhub ID of the company. Required when updating an existing company.

Example request body

 
 

json

{   "Name": "API Company",   "TaxNumber": "NL000099998B57",   "CompanyRegistrationNumber": "56583052",   "Street": "Example Street 123",   "PostalCode": "5848AL",   "City": "Amsterdam",   "Country": "Netherlands",   "PhoneNumber": "+3184933749",   "CountryCode": "NL",   "ExternalID": "2326" }

Response

On success, the API returns the CompanyID of the created or updated company.

 
 

json

{   "CompanyID": "14073748840908986" }

Related Articles