POST /contacts/v1/establish

Overview

Creates or returns a contact using the Contact Key and Contact Type provided in the payload.

JSON Parameters

NameTypeDescription
contactKeysarrayRequiredString array of one or more contact keys.
contactTypenumberThe default contact type is "Default" or 0. Most users do not modify the default value.
returnResultsbooleanIndicates if the call returns results. The default value is true.
correlateResponseItembooleanIndicates if the result items' return order matches the request order. The default value is true.
includeNewContactAwarenessbooleanIndicates that the contact has never been included in the results before. The default value is true.

Usage

Required Marketing Cloud Permissions

  • Contact Builder, Administer Contact Data Model
  • Contact Builder, Access

Example Request

Example Response

Example Fast Fire and Forget Request

Example Fast Fire and Forget Response