Skip to main content
POST
/
v2
/
integrations
/
clients
curl --location 'https://integrations.projectcor.com/v2/integrations/clients' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "SALESFORCE"
  },
  "id": "SF-ACC-67890",
  "name": "Acme Corporation",
  "business_name": "Acme Corporation LLC",
  "email_contact": "contact@acme.com",
  "name_contact": "Jane",
  "last_name_contact": "Smith",
  "phone": "+1 555-0100",
  "website": "https://acme.com",
  "description": "Enterprise software solutions provider"
}'

{
  "id": 25855,
  "name": "Acme Corporation",
  "business_name": "Acme Corporation LLC",
  "email_contact": "contact@acme.com",
  "name_contact": "Jane",
  "last_name_contact": "Smith",
  "phone": "+1 555-0100",
  "website": "https://acme.com",
  "description": "Enterprise software solutions provider",
  "company_id": 1234,
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-10T14:30:00Z"
}
Creates a new client in your COR instance through the integrations service. The client is mapped to an external ID from your source system for bidirectional synchronization.

​
Request Body Requirements

All requests require the metadata.source field to identify the integration source.
​
metadata
object
required
​
id
string
required
External client ID from your source system. This ID will be used to reference the client in future operations.
​
name
string
required
Client display name
​
business_name
string
Legal business name for contracts and invoicing
​
email_contact
string
Primary contact email address
​
name_contact
string
Contact person’s first name
​
last_name_contact
string
Contact person’s last name
​
phone
string
Phone number
​
website
string
Website URL
​
description
string
Client description

​
Known Errors

  • ValidationError — Missing required fields (metadata.source, id, or name)
  • DuplicateExternalIdError — A client with this external ID already exists for this source
  • InvalidSourceError — The metadata.source value is not a valid integration source
curl --location 'https://integrations.projectcor.com/v2/integrations/clients' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "SALESFORCE"
  },
  "id": "SF-ACC-67890",
  "name": "Acme Corporation",
  "business_name": "Acme Corporation LLC",
  "email_contact": "contact@acme.com",
  "name_contact": "Jane",
  "last_name_contact": "Smith",
  "phone": "+1 555-0100",
  "website": "https://acme.com",
  "description": "Enterprise software solutions provider"
}'

{
  "id": 25855,
  "name": "Acme Corporation",
  "business_name": "Acme Corporation LLC",
  "email_contact": "contact@acme.com",
  "name_contact": "Jane",
  "last_name_contact": "Smith",
  "phone": "+1 555-0100",
  "website": "https://acme.com",
  "description": "Enterprise software solutions provider",
  "company_id": 1234,
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-10T14:30:00Z"
}