Add New Follow-Up Status

Production

https://{{subdomain}}.daftara.com/v2/api/entity

POST

/follow_up_status

Creates a follow-up status.

This is a v2 native-entity endpoint served from the /v2/api/entity base and authenticated with a Bearer token. Send a flat JSON object whose keys are the fields below; name, status, and staff_id are required and any unknown key is ignored.

On success the id of the new status is returned.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Status created successfully.

Bodyapplication/json

🟠401Unauthorized

🟠400Bad Request

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://.daftara.com/v2/api/entity/follow_up_status' \
--header 'Accept: application/json' \
--header 'apikey: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "item_type": 1,
    "name": "Awaiting reply",
    "color": "#ff0000",
    "status": 1,
    "staff_id": 5
}'

Response Example

200 - Success

{
    "message": "تم إضافة حالة المتابعة بنجاح",
    "id": 23
}

Get Single Follow-Up Status

Delete Follow-Up Status