Skip to main content
POST
Create Contact Exclusion

Authorizations

Authorization
string
header
required

Bearer API key issued from Settings → Developers.

Body

application/json

Create Contact Exclusion payload

reason
enum<string>
required

Why the contact is being excluded.

Available options:
BAD_TIMING,
BOUNCED,
COMPETITOR,
CONTACT_REFUSED,
INTERESTED,
MEETING,
OTHER,
OUT_OF_OFFICE,
UNKNOWN,
UNSUBSCRIBED,
WRONG_PERSON,
EXCLUDE_FROM_SEARCH,
EXCLUDE_FROM_CRM,
REFERRAL,
LEFT_COMPANY
email
string | null

Email to exclude. At least one of email or linkedin_url is required.

linkedin_url
string | null

LinkedIn URL to exclude. At least one of email or linkedin_url is required.

message
string | null

Free-form note for operators.

until
string<date-time> | null

When the exclusion expires. Omit for a permanent exclusion.

Response

201 - application/json

Successful Response

id
string<uuid>
required

Unique identifier.

email
string | null
required

Excluded email.

linkedin_url
string | null
required

Excluded LinkedIn URL.

reason
enum<string>
required

Reason for the exclusion.

Available options:
BAD_TIMING,
BOUNCED,
COMPETITOR,
CONTACT_REFUSED,
INTERESTED,
MEETING,
OTHER,
OUT_OF_OFFICE,
UNKNOWN,
UNSUBSCRIBED,
WRONG_PERSON,
EXCLUDE_FROM_SEARCH,
EXCLUDE_FROM_CRM,
REFERRAL,
LEFT_COMPANY
message
string | null
required

Operator note.

until
string<date-time> | null
required

When the exclusion expires.

created_at
string<date-time>
required

When the exclusion was created.

updated_at
string<date-time>
required

When the exclusion last changed.