Create a contact

Body

string

required

The contact’s email address. Unique within the project.

string

Given name.

string

Family name.

boolean

Whether the contact is opted in. Defaults to true. When false, unsubscribedAt is stamped on create.

object

Free-form key/value pairs stored alongside the contact.

Subscription is not suppression. The subscribed flag is an app-level marketing signal. It does not block delivery — that’s the job of suppressions. A complaint still drops a message even if subscribed is true.

Request

curl https://api.drin.run/v1/contacts \
  -H "Authorization: Bearer $DRIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "firstName": "Ada",
    "lastName": "Lovelace",
    "metadata": { "plan": "pro" }
  }'

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

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

const contact = await drin.contacts.create({
  email: "ada@example.com",
  firstName: "Ada",
  lastName: "Lovelace",
  metadata: { plan: "pro" },
});

Response

Returns 201 Created with the contact. If a contact with the same email already exists in this project, the call returns 409 conflict (contact_email_taken).

201 Created

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

Overview

Emails

Domains

Inboxes

Threads

Inbound

Webhooks

Suppressions

Contacts

Templates

Metrics

API keys

Create a contact

Body

Request

Response

​Body

​Request

​Response

Body

Request

Response