Create a reusable customer tag

POST

/v1/tags

Creates a reusable tag that can later be associated with customer records (e.g. "VIP Customer").

Required scope: customers:write

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Tag created successfully.

Bodyapplication/json

🟠400

🟠401

🟠403

🟠409

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.fieldedge.com/open-api/v1/tags' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "string"
}'

Response Example

201 - Example 1

{
    "tagId": "string",
    "name": "string",
    "createdAt": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-08-27 11:27:00

Remove a tag from a customer

Retrieve tags