Create a new contact property

POST/contact-propertiesCreate a new contact property

Request body

application/json

objectCreateContactPropertyOptions

fallback_valuevalue

The default value to use when the property is not set for a contact. Must match the type specified in the type field.

Show child attributes

oneOf · 2 options

Option 1string

Option 2number

keystringrequired

The property key. Max length is 50 characters. Only alphanumeric characters and underscores are allowed.

typestringrequired

The property type.

one of "string", "number"

Example request

{
  "fallback_value": "string",
  "key": "string",
  "type": "number"
}

Responses

objectCreateContactPropertyResponseSuccess

idstring

The ID of the contact property.

objectstring

The object type of the response.

Example response

{
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "object": "contact_property"
}

Examples

curl -X POST 'https://api.resend.com/contact-properties' \
  -H 'Content-Type: application/json' \
  -d '{"fallback_value":"string","key":"string","type":"number"}'

const response = await fetch('https://api.resend.com/contact-properties', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"fallback_value":"string","key":"string","type":"number"}),
});
const data = await response.json();

const response = await fetch('https://api.resend.com/contact-properties', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: "{\"fallback_value\":\"string\",\"key\":\"string\",\"type\":\"number\"}" });
console.log(await response.json());

import requests

response = requests.request(
    "POST",
    "https://api.resend.com/contact-properties",
    headers={"Content-Type": "application/json"},
    data='{"fallback_value":"string","key":"string","type":"number"}',
)
print(response.json())

package main

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

func main() {
	ctx := context.Background()
	body := strings.NewReader(`{"fallback_value":"string","key":"string","type":"number"}`)
	req, err := http.NewRequestWithContext(ctx, "POST", "https://api.resend.com/contact-properties", 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/contact-properties");
curl_setopt($request, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($request, CURLOPT_POSTFIELDS, "{\"fallback_value\":\"string\",\"key\":\"string\",\"type\":\"number\"}");
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/contact-properties"))
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"fallback_value\":\"string\",\"key\":\"string\",\"type\":\"number\"}"))
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI("https://api.resend.com/contact-properties")
request = Net::HTTPGenericRequest.new("POST", true, true, uri)
request['Content-Type'] = 'application/json'
request.body = "{\"fallback_value\":\"string\",\"key\":\"string\",\"type\":\"number\"}"
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/contact-properties");
request.Content = new StringContent("{\"fallback_value\":\"string\",\"key\":\"string\",\"type\":\"number\"}", Encoding.UTF8, "application/json");
using var response = await client.SendAsync(request);

{
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "object": "contact_property"
}

Search documentation

Emails

Domains

Audiences

Contacts

Receiving Emails

Webhooks

Templates

Broadcasts

Segments

Topics

Contact Properties

Logs

Automations

Events

API keys