Skip to main content
POST
Add Contact Action

Authorizations

X-API-Key
string
header
required

Body

application/json
enrollmentId
string
required

Required exact enrollmentId returned by create_contact_sequence or selected with find_mcp_enrollment.

  • Must identify a single-contact sequence, including one created by the earlier Dynamic Actions tool; ordinary Flow Plan enrollment ids are rejected.
action
object
required

Exactly one action: email, linkedin_connect, linkedin_message, linkedin_inmail, linkedin_profile_view, manual_task, or call_task.

  • Use the matching typed payload.
  • Email requires final prompt content and a subject for a new thread; LinkedIn InMail requires prompt and subject.
  • Call and manual tasks require assignedUserId.
  • Email uses emailAccountId, not assignedUserId.
  • Approval defaults to enabled.
  • A delay uses hh:mm:ss or d.hh:mm:ss; follow-up emails and LinkedIn chat actions enforce their remaining three-hour gap.
contact
object | null

Optional verified fields to fill missing contact data. Existing exact identity wins; conflicting identifiers are rejected. If either name is missing, provide both firstName and lastName. Does not retarget the enrollment.

company
object | null

Optional verified company fields to fill missing context. Stored values are not overwritten.

priority
integer | null

Optional priority update for the whole enrollment: 1 High, 0 normal, -1 Low. Omit to preserve priority.

sourceDescription
string | null

Optional replacement relationship or origin context, up to 500 characters. Omit to preserve the existing description.

allowUnreadyLinkedInAccount
boolean | null

Allow authoring a LinkedIn action despite account readiness problems only after the customer explicitly requests it. Does not bypass Social permission, contact URL, or runtime readiness and plan checks.

allowExcludedContact
boolean | null

Omit or set false on the first attempt. Set true only after an exclusion rejection and explicit customer confirmation to bypass it for this call. Does not remove exclusions.

Response

Tool result.