Sales & CRMMu Mutation

createContact

Topics: Commerce

Create a new contact. Requires contact:write permission.

Returns

UpsertContactPayload!

Arguments

Contact data

Examples

Add Customer Contact

mutation AddCustomerContact($input: CreateContactInput!) {
  createContact(input: $input) {
    contact { id customerId firstName lastName email jobTitle isPrimary }
    errors { path message }
  }
}

Variables

{
  "input": {
    "customerId": "cus_01h455vb4pex5vsknk084sn02q",
    "firstName": "Maya",
    "lastName": "Chen",
    "email": "maya.chen@northstar.example",
    "jobTitle": "Operations Manager",
    "isPrimary": true
  }
}

Example response

{
  "data": {
    "createContact": {
      "contact": {
        "id": "con_01h455vb4pex5vsknk084sn02r",
        "customerId": "cus_01h455vb4pex5vsknk084sn02q",
        "firstName": "Maya",
        "lastName": "Chen",
        "email": "maya.chen@northstar.example",
        "jobTitle": "Operations Manager",
        "isPrimary": true
      },
      "errors": []
    }
  }
}
Exact field SDL
"""Create a new contact. Requires contact:write permission."""
createContact(
  """Contact data"""
  input: CreateContactInput!
): UpsertContactPayload! @topic(names: ["commerce"]) @topic_example(names: ["crm.add-customer-contact"])

Declared on Mutation. Access is checked by the platform for each operation.