Create Tag

posthttps://api.flxpoint.com/tags

Use this when you want to create tags data through the API.

🔑 X-API-TOKEN⏱ 2 req/sToken: Account · Source · Channel

This page explains the endpoint. To send a live test request, use the interactive tester in Stoplight or your own Postman / HTTP client.

Creates a tag. Tag names are unique per account.

Request

Bodyapplication/json

namestringrequired

Example request

post/tags

curl -X POST "https://api.flxpoint.com/tags" \
  -H "Accept: application/json" \
  -H "X-API-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
         "name": "string"
       }'

Example body · application/json

{
  "name": "string"
}

Responses

201Createdapplication/json

idinteger

namestring

Example response

{
  "id": 0,
  "name": "string"
}

400Bad Request

No schema documented for this status.

401Unauthorized

No schema documented for this status.

409Conflict - a tag with this name already exists

No schema documented for this status.

OpenAPI fragment

{
  "post": {
    "summary": "Create Tag",
    "description": "Creates a tag. Tag names are unique per account.",
    "parameters": [],
    "requestBody": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/SaveTagRequest"
          }
        }
      }
    },
    "responses": {
      "201": {
        "description": "Created",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Tag"
            }
          }
        }
      },
      "400": {
        "description": "Bad Request"
      },
      "401": {
        "description": "Unauthorized"
      },
      "409": {
        "description": "Conflict - a tag with this name already exists"
      }
    }
  }
}

Ready to run it? Send the curl from your terminal or Postman, or use the interactive tester in Stoplight.Open in Stoplight