Detach promo code

Description

Detaches a promotion code from a profile.

Use one of these parameters for profile matching:

• email
• field_name, field_value
• phone
• profile_id

If no "code" parameter is specified or if a specified code is attached to multiple profiles — an error will be returned.

Request URL

method: POST

https://example.com/api/v1.1/promocodes/detach

Request parameters

Parameter	Type	Example	Required	Description
token	string	"abcdefghijklmnqrstuvwxyz"	Yes	API token
code	string	"CODE-12345"	No	Promotion code
db_id	int	1	Yes	Database ID
email	string	"john@example.com"	No	Email address
format	string	"json"	No	Response data format. By default – json
field_name	string		No	Custom profile matching field
field_value	string		No	Custom field value
matching	string	"profile_id" "email" "phone" "custom"	No	Profiles matching mode
loyalty_id	int	1	Yes	Loyalty program ID

Request example

{
    "code": "CODE-12345",
    "db_id": 1,
    "loyalty_id": 1,
    "profile_id": "abcdefghijklmnqrstuvwxyz",
    "token": "abcdefghijklmnqrstuvwxyz"
}

Response example

{
    "data": null,
    "error": 0,
    "error_text": "Successful operation"
}

Response parameters

Parameter	Type	Description
error	int	Error code
error_text	string	Error text