v1

latestOpenAPI 3.0.02026-07-2447166133.5 KB
Contact Tags

Create a contact tag

This operation creates a contact tag for the given organization. This tag can then be applied to contacts in subsequent operations. Requesting creation of an already existing tag will result in a 201 response and the response will contain the existing tag.

post/contacts/tags

Headers

s-idempotency-keystring

A unique value generated by the client used to recognize subsequent retries of the same request. Idempotency keys can be up to 255 characters long.

Request body

valuestring required

The text value of a contact tag

Example request

{
  "value": "Smith"
}

Response

created

idstring required

Spruce's contact tag ID

objectstring required

String representing the object's type

valuestring required

The text value of a contact tag

Example response

{
  "id": "tag_0E5QDGJC03000",
  "value": "Smith"
}