Contents x
    /contact/create
    • 1 Minute to read
    • Print
    • Dark
      Light
    Contents

    /contact/create

    • 1 Minute to read
    • Print
    • Dark
      Light
    Article summary

    The "Post /contact/create" endpoint is designed to create a new contact using the provided contact object information. It allows for various identifiers to be included in the request body. The request body must be formatted in JSON and includes parameters such as contactId (integer), emailAddress (string), mobileNumber (string), applicationAlias (string), identifier (string), attributes (an array of objects with name and value), unifiedIdentifiers (an array of objects with name and value), and channelAddresses (an array of objects with name and value). Successful requests return a 200 status code with the contact details, while a 400 status code indicates that the contact already exists. This functionality is essential for managing contact information effectively within applications.

    Post
    /contact/create

    Creates a new contact using the information provided in the contact object.

    Check Contact_ for possible identifiers in the body.
    Request body examples:

    {
    "emailAddress": "test20210203@dropmail.mapp.com",
    "attributes":
    [
    {"name": "FirstName", "value": "John"},
    {"name": "LastName", "value": "Smith"},
    {"name": "mobileNumber", "value": "33505606709"},
    {"name": "user.ISOCountryCode", "value": "FR"}
    ]
    }

    {
      "emailAddress" : "testuser@dropmail.mapp.com"
    }

    Body parameters
    Expand All
    object
    contactId
    integer (int64)
    emailAddress
    string
    mobileNumber
    string
    applicationAlias
    string
    identifier
    string
    attributes
    Array of object (Attribute)
    object
    name
    string
    value
    string
    unifiedIdentifiers
    Array of object (Attribute)
    object
    name
    string
    value
    string
    channelAddresses
    Array of object (Attribute)
    object
    name
    string
    value
    string
    Responses
    200
    Expand All
    object
    contactId
    integer (int64)
    emailAddress
    string
    mobileNumber
    string
    applicationAlias
    string
    identifier
    string
    attributes
    Array of object (Attribute)
    object
    name
    string
    value
    string
    unifiedIdentifiers
    Array of object (Attribute)
    object
    name
    string
    value
    string
    channelAddresses
    Array of object (Attribute)
    object
    name
    string
    value
    string
    400

    Such contact already exists

    Was this article helpful?
    What's Next