Create a new contact

POST/contactsCreate a new contact

Request body

application/json

objectCreateContactOptions

audience_idstring

Unique identifier of the audience to which the contact belongs.

emailstringrequired

Email address of the contact.

first_namestring

First name of the contact.

last_namestring

Last name of the contact.

propertiesobject

A map of custom property keys and values to create.

segmentsarray of string

Array of segment IDs to add the contact to.

Show child attributes

topicsarray of object

Array of topic subscriptions for the contact.

Show child attributes

Show array items

idstring

The topic ID.

subscriptionstring

The subscription status for this topic.

one of "opt_in", "opt_out"

unsubscribedboolean

The Contact's global subscription status. If set to true, the contact will be unsubscribed from all Broadcasts.

Example request

{
  "audience_id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "email": "steve.wozniak@gmail.com",
  "first_name": "Steve",
  "last_name": "Wozniak",
  "properties": {
    "additionalProp1": null
  },
  "segments": [
    "string"
  ],
  "topics": [
    {
      "id": "string",
      "subscription": "opt_in"
    }
  ],
  "unsubscribed": false
}

Responses

objectCreateContactResponseSuccess

idstring

Unique identifier for the created contact.

objectstring

Type of the response object.

Example response

{
  "id": "479e3145-dd38-476b-932c-529ceb705947",
  "object": "contact"
}

Examples

curl -X POST 'https://api.resend.com/contacts' \
  -H 'Content-Type: application/json' \
  -d '{"audience_id":"78261eea-8f8b-4381-83c6-79fa7120f1cf","email":"steve.wozniak@gmail.com","first_name":"Steve","last_name":"Wozniak","properties":{"additionalProp1":null},"segments":["string"],"topics":[{"id":"string","subscription":"opt_in"}],"unsubscribed":false}'

const response = await fetch('https://api.resend.com/contacts', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"audience_id":"78261eea-8f8b-4381-83c6-79fa7120f1cf","email":"steve.wozniak@gmail.com","first_name":"Steve","last_name":"Wozniak","properties":{"additionalProp1":null},"segments":["string"],"topics":[{"id":"string","subscription":"opt_in"}],"unsubscribed":false}),
});
const data = await response.json();

const response = await fetch('https://api.resend.com/contacts', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: "{\"audience_id\":\"78261eea-8f8b-4381-83c6-79fa7120f1cf\",\"email\":\"steve.wozniak@gmail.com\",\"first_name\":\"Steve\",\"last_name\":\"Wozniak\",\"properties\":{\"additionalProp1\":null},\"segments\":[\"string\"],\"topics\":[{\"id\":\"string\",\"subscription\":\"opt_in\"}],\"unsubscribed\":false}" });
console.log(await response.json());

import requests

response = requests.request(
    "POST",
    "https://api.resend.com/contacts",
    headers={"Content-Type": "application/json"},
    data='{"audience_id":"78261eea-8f8b-4381-83c6-79fa7120f1cf","email":"steve.wozniak@gmail.com","first_name":"Steve","last_name":"Wozniak","properties":{"additionalProp1":null},"segments":["string"],"topics":[{"id":"string","subscription":"opt_in"}],"unsubscribed":false}',
)
print(response.json())

package main

import (
	"context"
	"net/http"
	"strings"
)

func main() {
	ctx := context.Background()
	body := strings.NewReader(`{"audience_id":"78261eea-8f8b-4381-83c6-79fa7120f1cf","email":"steve.wozniak@gmail.com","first_name":"Steve","last_name":"Wozniak","properties":{"additionalProp1":null},"segments":["string"],"topics":[{"id":"string","subscription":"opt_in"}],"unsubscribed":false}`)
	req, err := http.NewRequestWithContext(ctx, "POST", "https://api.resend.com/contacts", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

<?php
$request = curl_init("https://api.resend.com/contacts");
curl_setopt($request, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($request, CURLOPT_POSTFIELDS, "{\"audience_id\":\"78261eea-8f8b-4381-83c6-79fa7120f1cf\",\"email\":\"steve.wozniak@gmail.com\",\"first_name\":\"Steve\",\"last_name\":\"Wozniak\",\"properties\":{\"additionalProp1\":null},\"segments\":[\"string\"],\"topics\":[{\"id\":\"string\",\"subscription\":\"opt_in\"}],\"unsubscribed\":false}");
curl_setopt($request, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($request);
curl_close($request);

var request = HttpRequest.newBuilder(URI.create("https://api.resend.com/contacts"))
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"audience_id\":\"78261eea-8f8b-4381-83c6-79fa7120f1cf\",\"email\":\"steve.wozniak@gmail.com\",\"first_name\":\"Steve\",\"last_name\":\"Wozniak\",\"properties\":{\"additionalProp1\":null},\"segments\":[\"string\"],\"topics\":[{\"id\":\"string\",\"subscription\":\"opt_in\"}],\"unsubscribed\":false}"))
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI("https://api.resend.com/contacts")
request = Net::HTTPGenericRequest.new("POST", true, true, uri)
request['Content-Type'] = 'application/json'
request.body = "{\"audience_id\":\"78261eea-8f8b-4381-83c6-79fa7120f1cf\",\"email\":\"steve.wozniak@gmail.com\",\"first_name\":\"Steve\",\"last_name\":\"Wozniak\",\"properties\":{\"additionalProp1\":null},\"segments\":[\"string\"],\"topics\":[{\"id\":\"string\",\"subscription\":\"opt_in\"}],\"unsubscribed\":false}"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://api.resend.com/contacts");
request.Content = new StringContent("{\"audience_id\":\"78261eea-8f8b-4381-83c6-79fa7120f1cf\",\"email\":\"steve.wozniak@gmail.com\",\"first_name\":\"Steve\",\"last_name\":\"Wozniak\",\"properties\":{\"additionalProp1\":null},\"segments\":[\"string\"],\"topics\":[{\"id\":\"string\",\"subscription\":\"opt_in\"}],\"unsubscribed\":false}", Encoding.UTF8, "application/json");
using var response = await client.SendAsync(request);

{
  "id": "479e3145-dd38-476b-932c-529ceb705947",
  "object": "contact"
}

Search documentation

Emails

Domains

Audiences

Contacts

Receiving Emails

Webhooks

Templates

Broadcasts

Segments

Topics

Contact Properties

Logs

Automations

Events

API keys