Add a category to multiple people

POST

/people/categories/add

Add a single category to one or more people

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Category added successfully

Body

🟠400

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/people/categories/add' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "emails": [
        "user1@example.com",
        "user2@example.com"
    ],
    "category": "automation",
    "label": "Q4 2024"
}'

Response Example

200 - Example 1

{
    "status": "success",
    "message": "Category contractor added to 5 users"
}

Modified at 2026-02-10 23:10:01

Get a person by id

Remove a category from multiple people