curl --request POST \
--url https://api.salescaptain.com/v1/create-tag \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"company_id": "7f22b96a-f75b-461e-9a1d-b8ff6f53f519",
"tag_name": "VIP Customer",
"status": true
}
'{
"message": "Tag created successfully!",
"tag": {
"data": {
"tag_id": "c9d8e7f6-a5b4-3210-9876-543210fedcba",
"company_id": "7f22b96a-f75b-461e-9a1d-b8ff6f53f519",
"tag_name": "VIP Customer",
"status": true,
"created_at": "2026-08-11T12:26:00.000Z",
"message": "Tag created successfully"
}
}
}Tags
Create a new tag
Creates a new tag for a specific company.
status is optional and defaults to true.
User must have ‘contacts’ access role to create tags.
account_id is derived from the authenticated user’s account for the company.
POST
/
v1
/
create-tag
curl --request POST \
--url https://api.salescaptain.com/v1/create-tag \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"company_id": "7f22b96a-f75b-461e-9a1d-b8ff6f53f519",
"tag_name": "VIP Customer",
"status": true
}
'{
"message": "Tag created successfully!",
"tag": {
"data": {
"tag_id": "c9d8e7f6-a5b4-3210-9876-543210fedcba",
"company_id": "7f22b96a-f75b-461e-9a1d-b8ff6f53f519",
"tag_name": "VIP Customer",
"status": true,
"created_at": "2026-08-11T12:26:00.000Z",
"message": "Tag created successfully"
}
}
}Authorizations
Authentication token required for accessing protected endpoints. The token should be obtained from the main SalesCaptain authentication service.
Body
application/json