Contacts

Create contact

Create a new contact. Optionally create a platform channel in the same request by providing accountId, platform, and platformIdentifier.

post/v1/contacts

Request body

profileIdstring required
namestring required
emailstring
companystring
tagsstring[]
isSubscribedboolean
notesstring
accountIdstring

Optional. Creates a channel if provided with platform + platformIdentifier

platform'instagram' | 'facebook' | 'telegram' | 'twitter' | 'bluesky' | 'reddit' | 'whatsapp' | 'slack' | 'sms'

Channel platform. Only the enum values support contact channels; any other platform is rejected with code platform_not_supported.

platformIdentifierstring
displayIdentifierstring

Response

Contact created

successboolean
warningstring

Changes

Changed in 2 of the 56 revisions of this API.19

    • ○

      added the new sms enum value to the request property

      request-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ▲

      request property was restricted to a list of enum values

      request-property-became-enum

    • ○

      added the new bluesky enum value to the request property

      request-property-enum-value-added

    • ○

      added the new facebook enum value to the request property

      request-property-enum-value-added

    • ○

      added the new instagram enum value to the request property

      request-property-enum-value-added

    • ○

      added the new reddit enum value to the request property

      request-property-enum-value-added

    • ○

      added the new slack enum value to the request property

      request-property-enum-value-added

    • ○

      added the new telegram enum value to the request property

      request-property-enum-value-added

    • ○

      added the new twitter enum value to the request property

      request-property-enum-value-added

    • ○

      added the new whatsapp enum value to the request property

      request-property-enum-value-added