Basic Details

Parameters used in all requests are described here.

Parameters

Name	Type	Requirement	Description
shop_id	string	required	Unique Store Key in PersonaClick. Located there: Account > Settings > Store Settings
shop_secret	string	required	Store Secret Key in PersonaClick. Located there: Account > Settings > Store Settings
email	string	required if "phone" property doesn't use	Email of the user to be added to the static segment.
phone	string	required if "email" property doesn't use	The phone number of the user to be added to the static segment.

Adding to a segment

Method Objective

The method allows adding the current user to a segment.

Request

Endpoint	Request Type	Content-Type
https://api.personaclick.com/segments/add	POST	application/x-www-form-urlencoded

Parameters

Only parameters related to the request for the adding user to the segment are listed here. See "Basic Details" above for more information on required parameters and the API endpoint.

Name	Type	Description
segment_id	number/string	Segment ID. It's available in the PersonaClick account: CRM > Segments.

API Response Code

HTTP status code	Description
200 OK	The request was successful.
403 Forbidden	The request was unsuccessful.
404 Not Found	There are no mandatory parameters in the query.

API Response Data

The response is JSON type with the following properties:

Name	Type	Description
status	string	Current status. Can have one of two values: success - the request was successful error - the request was unsuccessful
message	string	The text of the error if it occurred

Request Example

curl 'https://api.personaclick.com/segments/add' \
  -X 'POST' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -d 'shop_id=0d42fd8b713d0752776ca589cc0056&shop_secret=0123456789abcdef0123456789abcdef&email=john.doe%40examplemail.com&phone=4400114527199&segment_id=100500'

Removing from a segment

Method Objective

The method allows excluding the current user from a segment.

Request

Endpoint	Request Type	Content-Type
https://api.personaclick.com/segments/remove	POST	application/x-www-form-urlencoded

Parameters

Only parameters related to the request for the removing user from the segment are listed here. See "Basic Details" above for more information on required parameters and the API endpoint.

Name	Type	Description
segment_id	number/string	Segment ID. It's available in the PersonaClick account: CRM > Segments.

API Response Code

HTTP status code	Description
200 OK	The request was successful.
403 Forbidden	The request was unsuccessful.
404 Not Found	There are no mandatory parameters in the query.

API Response Data

The response is JSON type with the following properties:

Name	Type	Description
status	string	Current status. Can have one of two values: success - the request was successful error - the request was unsuccessful
message	string	The text of the error if it occurred

Request Example

curl 'https://api.personaclick.com/segments/remove' \
  -X 'POST' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -d 'shop_id=0d42fd8b713d0752776ca589cc0056&shop_secret=0123456789abcdef0123456789abcdef&email=john.doe%40examplemail.com&phone=4400114527199&segment_id=100500'

Syntax and parameters

personaclick("segment", "remove", params);

Name	Type	Requirement	Description
params	Object	required	Object with request parameters.

Request parameters

Name	Type	Requirement	Description
segment_id	number/string	required	Segment ID. It's available in the PersonaClick account: CRM > Segments.
email	string	optionally	The current user's Email.
phone	string	optionally	The current user's Phone.

Examples of use

personaclick("segment", "remove", {
    "segment_id": 100500,
    "email": "john.doe@examplestore.com",
    "phone": "+10000000000"
});

personaclick("segment", "remove", {
    "segment_id": 100500,
    "email": "john.doe@examplestore.com"
});

personaclick("segment", "remove", {
    "segment_id": 100500,
    "phone": "+10000000000"
});

personaclick("segment", "remove", {"segment_id": 100500});

Getting the segment list

Method Objective

The method allows getting a list of segments that include the current user.

Syntax and parameters

personaclick("segment", "get", callback);

Name	Type	Requirement	Description
callback	Function	required	The callback function that takes the API response. The API response type is an object.

API response

Type Description

Object array

Object array, each will have the following properties:

id (number) - the Segment ID.
type (string) - the Segment Type. It can have the following values: static, dynamic.

Example of use

personaclick("segment", "get", function(segments) {
    segments.forEach(function(segment) {
        console.log(segment.id);
        console.log(segment.type);
    });
});

Manage Segments (REST API)

Basic Details

Parameters

Adding to a segment

Method Objective

Request

Parameters

API Response Code

API Response Data

Request Example

Removing from a segment

Method Objective

Request

Parameters

API Response Code

API Response Data

Request Example

Syntax and parameters

Request parameters

Examples of use

Getting the segment list

Method Objective

Syntax and parameters

API response

Example of use