Gets a company by external reference (namespace + external ID).

Usage Example

Lookup by HubSpot ID:

GET /api/v1/network/companies/external/hubspot/12345

Lookup by Salesforce ID:

GET /api/v1/network/companies/external/salesforce/001ABC123

Use Cases

Quickly fetch Propstreet company data when you only have the CRM ID
Verify synchronization state between systems
Resolve webhook payloads that reference external IDs

Namespace Matching

Namespace matching is case-insensitive. "HubSpot", "hubspot", and "HUBSPOT" are treated as equivalent.

Path Parameters

namespace
Type: string
required

External system namespace (e.g., "hubspot", "salesforce", "pipedrive")
id
Type: string
required

External ID within the namespace

Responses

application/json
application/problem+json
application/problem+json
application/problem+json

get/api/v1/network/companies/external/{namespace}/{id}

curl 'https://app.propstreet.com/api/v1/network/companies/external/{namespace}/{id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "id": "string",
  "uri": null,
  "externalRefs": [
    {
      "namespace": "string",
      "id": "string"
    }
  ],
  "name": "string",
  "countryCode": null,
  "homepageUrl": null,
  "linkedInUrl": null,
  "domain": null,
  "tags": [
    "string"
  ],
  "strategy": null,
  "contacts": [
    {
      "id": "string",
      "uri": null,
      "firstName": null,
      "lastName": null,
      "email": null,
      "jobTitle": null,
      "isPrimary": true
    }
  ],
  "profilePictureUrl": null,
  "createdUtc": "2026-05-18T20:22:36.959Z",
  "updatedUtc": "2026-05-18T20:22:36.959Z",
  "deletedUtc": null,
  "etag": "string",
  "changeType": null,
  "changeOrigin": null
}

Returns the company