Create a tag

POST

/api/v3/contacts/tags

const url = 'https://api.tryletterhead.com/api/v3/contacts/tags';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"api":true,"name":"engaged-readers","color":"#4287f5"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.tryletterhead.com/api/v3/contacts/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "api": true, "name": "engaged-readers", "color": "#4287f5" }'

Authorizations

bearerAuth

Request Body^required

application/json

object

api

Required. Set to true to authenticate with an API key.

boolean

name

required

Letters, numbers, hyphens, underscores, and spaces only.

string

color

required

A hex color, e.g. #4287f5.

string

Example

{
  "api": true,
  "name": "engaged-readers",
  "color": "#4287f5"
}

Responses

201

Tag created

Still can’t find what you need? Contact support.