Skip to main content

Upsert lead contact channels

Merge email and phone channels into an existing lead.

POST/api/leads/{lead_id}/contact-channels
HTTP referenceScope leads:writeUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

At least one of emails, emailAddresses, phones, or phoneNumbers is required. Entries may be strings or objects; email objects require address (or alias email), phone objects require number (or alias phone). The handler merges channels, returns a summary, and serializes the returned lead. The request currently accepts untyped list items (Any); consult the returned lead for canonical channel shape.

Path parameters

  • lead_idrequired

    string

Body parameters

  • emails · optional

    array

  • emailAddresses · optional

    array

    Alias accepted by the HTTP request model.

  • phones · optional

    array

  • phoneNumbers · optional

    array

    Alias accepted by the HTTP request model.

Errors

StatusMeaning
401Missing or invalid authentication.
403Missing leads:write scope.
404Lead not found.
422At least one contact channel array is required.

Docs