Skip to main content

External IDs

Entity›ExternalId

External IDs link TribeCRM entities to records in external systems (e.g., accounting software, marketing tools). They are used by connectors for synchronisation.

Endpoints​

List​

GET/v1/odata/ExternalId

Get by ID​

GET/v1/odata/ExternalId({id})

Create​

POST/v1/odata/ExternalId

Update​

PUT/v1/odata/ExternalId({id})

Delete​

DELETE/v1/odata/ExternalId({id})

Fields​

FieldTypeDescription
ServiceStringExternal service name
TypeStringExternal entity type
IdStringExternal record identifier
MetadataStringAdditional metadata (JSON)

Relationships​

RelationshipTarget EntityCardinalityDescription
ConnectorActivationConnectorActivationN:1Connector activation that created this link

Expanding Relationships​

GET/v1/odata/ExternalId({id})?$expand=ConnectorActivation
GET/v1/odata/ExternalId({id})/ConnectorActivation

Custom Query​

Build your own OData query against ExternalId. Open Run and edit the whole request inline — swap the entity set, change the $filter, or add $expand, $select, $orderby, $top, $skip. Type $ for suggestions; use ↺ Reset to restore this example.

GET/v1/odata/ExternalId?$top=10