For the complete documentation index, see llms-docs.txt or the site index llms.txt. Full docs corpus: llms-full-docs.txt. Prefer the markdown version of this page at /docs/api/contacts/patch-api-contacts-v1by-contact_id.md. Product capabilities: skill.md. Docs MCP: /docs/mcp. Site MCP: https://reloop.sh/mcp.

Update Contact

PATCH
/api/contacts/v1/:contact_id
1import { Reloop } from "reloop-email";
2
3const reloop = new Reloop({ apiKey: "rl_123456789" });
4
5const { contact, contactError } = await reloop.contacts.update("con_123456789", { firstName: "Jane" });
6if (contactError) throw contactError;
1{
2 "object": "contact",
3 "id": "con_123456789",
4 "email": "john.doe@example.com",
5 "firstName": "John",
6 "lastName": "Doe",
7 "status": "subscribed",
8 "properties": {
9 "company": "Reloop",
10 "role": "Developer"
11 },
12 "groups": [
13 {
14 "id": "grp_123456789",
15 "name": "Beta Testers"
16 }
17 ],
18 "channels": [
19 {
20 "id": "channel_123456789",
21 "name": "Newsletter",
22 "subscription": "opt_in"
23 }
24 ],
25 "suppressionReason": null,
26 "suppressedAt": null,
27 "suppressionSource": "system",
28 "suppressionNote": "example_suppressionNote",
29 "createdAt": "2026-03-23T10:00:00.000Z",
30 "updatedAt": "2026-03-23T10:00:00.000Z",
31 "event": "evt_123456789"
32}

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.

Was this page helpful?