Update Contact

PATCH
https://reloop.sh/api/contacts/:contact_id

Path Parameters

contact_idstringRequired

Unique contact identifier

Body Parameters

emailstring

Contact email address

firstNamestring

Contact first name

lastNamestring

Contact last name

status"subscribed""unsubscribed""blocked"

Possible values: subscribed | unsubscribed | blocked

propertiesobject

Contact properties as key-value pairs to update

Custom properties
keystringRequired

The property key.

valuestringRequired

The property value.

import Reloop from 'reloop-email';

const reloop = new Reloop('re_123456789');

const { response: contact, error } = await reloop.contacts().update('cont_123456789', {
  firstName: 'Jane',
  lastName: 'Smith',
  status: 'subscribed',
  properties: {
    company: 'Reloop',
    role: 'Designer',
  },
});
if (error) throw error;
{
  "object": "contact",
  "id": "con_123456789",
  "email": "john.doe@example.com",
  "firstName": "John",
  "lastName": "Doe",
  "status": "subscribed",
  "properties": {
    "company": "Reloop",
    "role": "Developer"
  },
  "groups": [
    {
      "id": "grp_123456789",
      "name": "Beta Testers"
    }
  ],
  "channels": [
    {
      "id": "channel_123456789",
      "name": "Newsletter",
      "subscription": "opt_in"
    }
  ],
  "suppressionReason": null,
  "suppressedAt": null,
  "createdAt": "2026-03-23T10:00:00.000Z",
  "updatedAt": "2026-03-23T10:00:00.000Z",
  "event": "evt_123456789"
}

Was this page helpful?

Edit this page