Skip to main content
POST
https://integrations.projectcor.com
/
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"
}