LOloops
Contacts

Update a contact

Changed on

Update a contact by email or userId. You must provide one of these parameters.

If you want to update a contact's email address, the contact will first need a userId value. You can then make a request containing the userId field along with an updated email address.

This endpoint will create a contact if a matching contact does not already exist in your audience.

Provide either email or userId to identify the contact you want to update. If both are provided, the system will look for a contact with either a matching email or userId value. If a contact is found for one of the values (e.g. email), the other value (e.g. userId) will be updated. If a contact is not found, a new contact will be created using both email and userId values.

put/v1/contacts/update

Request

  • Base URL
    https://app.loops.so/api
  • Auth
    HTTP bearer

Request body

OR

Example request

{
  "email": "alex@company.com",
  "firstName": "Alex",
  "lastName": "Rivera",
  "subscribed": true,
  "userGroup": "customers",
  "userId": "usr_7f8e9d0c1b2a",
  "mailingLists": {
    "clm2k8j4h6g0f8d6s4a2b0z8": true
  },
  "favoriteColor": "blue"
}

Response

Successful update.

successboolean required
idstring required

Example response

{
  "success": true,
  "id": "clh3k9m2p4q6r8s0t2v4x6z8"
}

Changes

  • ac25499abd64Revision changes
    • breaking

      removed subschema #1 subschema #2 from the request property anyOf list

    • breaking

      removed subschema #1 subschema #2 subschema #3 from the request property oneOf list

    • breaking

      removed subschema #1 subschema #2 subschema #3 from the //// request property oneOf list

    • info

      added subschema #1: Identify by email subschema #2: Identify by user ID to the request property anyOf list

    • info

      added subschema #1: String subschema #2: Number subschema #3: Boolean to the request property oneOf list

    • info

      added subschema #1: String subschema #2: Number subschema #3: Boolean to the //// request property oneOf list

  • 74756bcb2e9eRevision changes
    • info

      api operation id updateContact was added