Update a contact

Body

Send any subset of the following.

string | null

New given name. Pass null to clear it.

string | null

New family name. Pass null to clear it.

object

Replace the contact’s metadata object.

Flip subscription with the dedicated endpoints. To opt a contact in or out, prefer unsubscribe and resubscribe — they also stamp and clear unsubscribedAt for you.

Request

curl -X PATCH https://api.drin.run/v1/contacts/ct_7Yh2Lp \
  -H "Authorization: Bearer $DRIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "lastName": "King", "metadata": { "plan": "scale" } }'

import { DrinClient } from "@drin00/sdk";

const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

await drin.contacts.update("ct_7Yh2Lp", {
  lastName: "King",
  metadata: { plan: "scale" },
});

// Pass null to clear a name field.
await drin.contacts.update("ct_7Yh2Lp", { firstName: null });

Response

Returns 200 OK with the updated contact. An unknown id returns 404 not_found.

200 OK

{
  "id": "ct_7Yh2Lp",
  "email": "ada@example.com",
  "firstName": "Ada",
  "lastName": "King",
  "subscribed": true,
  "unsubscribedAt": null,
  "metadata": { "plan": "scale" },
  "createdAt": "2026-06-02T17:30:00.000Z",
  "updatedAt": "2026-06-02T18:05:11.000Z"
}

Overview

Emails

Domains

Inboxes

Threads

Inbound

Webhooks

Suppressions

Contacts

Templates

Metrics

API keys

Update a contact

Path parameters

Body

Request

Response

​Path parameters

​Body

​Request

​Response

Path parameters

Body

Request

Response