Create a Tag

POST

https://api.mottasl.ai/v1/tags

Last modified:2025-12-16 12:42:03

Using this endpoint you'll be able to create a new single tag with a description and a color.

You can use the any color picker for Hex Codes like https://htmlcolorcodes.com/

Descriptions are important if you have multiple tags in you account and you need to distinguish between them later on.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "tag": "VIP",
    "description": "VIP client",
    "colour": "#e74266"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.mottasl.ai/v1/tags' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "tag": "VIP",
    "description": "VIP client",
    "colour": "#e74266"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "data": {
        "id": 97451,
        "business_id": "8e4c6c2f-2f73-0000-0000-0000",
        "tag": "VIP",
        "colour": "#1ca08a",
        "description": "VIP Client",
        "created_by": 3077323,
        "display_name": "",
        "updated_at": "2025-10-12T08:40:43.163004Z",
        "created_at": "2025-10-12T08:40:43.163004Z"
    },
    "message": "Tag created successfully",
    "success": true
}

🔴500InternelError

🟠400BadRequest

Modified at 2025-12-16 12:42:03

Delete Webhook

List All Tags