contacts

Create Contact Exclusion

Changed on

Create a new contact-level exclusion.

Requires the contact_exclusions:write scope on the API key.

post/v1/contact-exclusions

Request

  • Base URL: https://api.topo.io
  • URL: https://api.topo.io/v1/contact-exclusions
  • Auth: HTTP bearer

Request body

emailstring nullable

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

linkedin_urlstring nullable

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

reason'BAD_TIMING' | 'BOUNCED' | 'COMPETITOR' | 'CONTACT_REFUSED' | 'INTERESTED' | 'MEETING' | 'NOT_INTERESTED' | 'OTHER' | 'OUT_OF_OFFICE' | 'UNKNOWN' | 'UNSUBSCRIBED' | 'WRONG_PERSON' | 'EXCLUDE_FROM_SEARCH' | 'EXCLUDE_FROM_CRM' | 'REFERRAL' | 'LEFT_COMPANY' required
messagestring nullable

Free-form note for operators.

untilstring date-time nullable

When the exclusion expires. Omit for a permanent exclusion.

Response

Successful Response

idstring uuid required

Unique identifier.

emailstring nullable required

Excluded email.

linkedin_urlstring nullable required

Excluded LinkedIn URL.

reason'BAD_TIMING' | 'BOUNCED' | 'COMPETITOR' | 'CONTACT_REFUSED' | 'INTERESTED' | 'MEETING' | 'NOT_INTERESTED' | 'OTHER' | 'OUT_OF_OFFICE' | 'UNKNOWN' | 'UNSUBSCRIBED' | 'WRONG_PERSON' | 'EXCLUDE_FROM_SEARCH' | 'EXCLUDE_FROM_CRM' | 'REFERRAL' | 'LEFT_COMPANY' required
messagestring nullable required

Operator note.

untilstring date-time nullable required

When the exclusion expires.

created_atstring date-time required

When the exclusion was created.

updated_atstring date-time required

When the exclusion last changed.

Changes

  • 4c947c3f2e11Revision changes
    • warning

      added the new NOT_INTERESTED enum value to the response property for the response status

    • info

      added the new NOT_INTERESTED enum value to the request property