API documentation
Method list
Test your request
Changelog


addCrmClientStatus
Creates a new CRM client status or updates an existing one if status_id is provided. A new status is appended at the end of the status list within its group.


Input parameters
status_idintStatus ID. Provide to update an existing status. Leave empty or omit when creating a new status.
namevarchar(30)Status name displayed in the panel.
colorvarchar(7)Status color in hex format (e.g., "#FF0000").
group_idintStatus group ID. If omitted on create, the status is placed in the main (default) group. On update, if not provided, the existing group assignment is kept.



Output data
The method returns the data in JSON format.
statusvarchar(30)SUCCESS - request executed correctly
ERROR - an error occurred during an API request. Error details will be described in 2 additional returned fields: error_message and error_code
status_idintID of the created or updated status.



Sample
Input data:
Output data:
A sample request in PHP: