Skip to main content
POST
Create an Internal Contact

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request body for creating an internal contact and recording their role.

email
string
required

The internal contact's email address.

Minimum string length: 1
internal_role
enum<string>
required
Available options:
account_manager,
account_executive,
csm,
lead,
co_lead,
practice_lead
given_name
string | null

The internal contact's given name.

family_name
string | null

The internal contact's family name.

name
string | null

The internal contact's full name, if no given/family name.

phone
string | null

The internal contact's phone number.

job_title
string | null

The internal contact's job title.

Response

Successful Response

An InternalContact assigned to a Partner with a specific role.

partner_id is null for "floating" assignments — contacts whose role is declared at the organization level but who have not yet been attached to a specific partner.

created_at
string<date-time>
required
modified_at
string<date-time> | null
required
id
string
required
internal_role
enum<string>
required

The role this internal contact holds for this partner.

Available options:
account_manager,
account_executive,
csm,
lead,
co_lead,
practice_lead
partner_id
string | null
required
remote_id
string | null
required

Third-party sync identifier for upsert deduplication.

internal_contact
object
required

An internal contact (CSM, AM, etc.) at the organization level.

object
string
required
read-only

String representing the object's type. Objects of the same type share the same value.