maxLevel2classpersonaclick-fixed-position

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-urlencodedjson

Parameters

Note
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 queryrequest.

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

Code Block

language	js
theme	FadeToGrey

curl 'https://api.personaclick.com/segments/add' \
  -X 'POST' \
  -H 'content-type: application/x-www-form-urlencodedjson' \
  -d '{"shop_id=0d42fd8b713d0752776ca589cc0056&":"0d42fd8b713d0752776ca589cc0056","shop_secret=0123456789abcdef0123456789abcdef&email=john.doe%40examplemail.com&phone=4400114527199&segment_id=100500":"0123456789abcdef0123456789abcdef","email":"john.doe@examplemail.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

json

Parameters

Note
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/stringSegment 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

request.

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

Code Block

language	js
theme	FadeToGrey

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

Syntax and parameters

Code Block

language	js
theme	FadeToGrey

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

NameTypeRequirementDescriptionparamsObjectrequiredObject with request parameters.

Request parameters

NameTypeRequirement

":"0123456789abcdef0123456789abcdef","email":"john.doe@examplemail.com","phone":"4400114527199","segment_id":100500}'

Getting the segment list

Method Objective

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

Request

Endpoint	Request Type
https://api.personaclick.com/segments/get	GET

Parameters

Note
See "Basic Details" above for more information on required parameters.

Name	Type	Description
segment_id	number/string

required

Segment ID. It's available in the PersonaClick account: CRM > Segments.

emailstringoptionallyThe current user's Email.phonestringoptionally

The current user's Phone.

Examples of use

Code Block

language	js
theme	FadeToGrey

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

Code Block

language	js
theme	FadeToGrey

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

Code Block

language	js
theme	FadeToGrey

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

Code Block

language	js
theme	FadeToGrey

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

Code Block

language	js
theme	FadeToGrey

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

NameTypeRequirementDescriptioncallbackFunctionrequiredThe callback function that takes the API response. The API response type is an object.

API response

TypeDescriptionObject 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

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 request.

API Response Data

The response is JSON type with the following properties:

Name

Type

Description

status

string

Available only in case of an error. Contains the "error" value in this case.

message

string

Available only in case of an error. Contains a description of the error.

(has no name)

Object array

Object array with the following properties:

id - segment ID
type - segment type, can have one of the following values: dynamic, static, rfm.

Request Example

Code Block

language	js
theme	FadeToGrey

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

Table of Contents

curl 'https://api.personaclick.com/segments/get?shop_id=0d42fd8b713d0752776ca589cc0056&shop_secret=0123456789abcdef0123456789abcdef&email=john.doe%40examplemail.com'

Column

Page Navigation

Table of Contents

maxLevel	1
indent	0px
style	none

Related Pages

Filter by label (Content by label)

showLabels	false
showSpace	false
sort	title
cql	label = "segments"

Versions Compared

Old Version 4

New Version Current

Key

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

Getting the segment list

Method Objective

Request

Parameters

Examples of use

Getting the segment list

Method Objective

Syntax and parameters

API response

API Response Code

API Response Data

Request Example

Page Comparison

Versions Compared

Old Version 4

New Version Current

Key

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

Getting the segment list

Method Objective

Request

Parameters

Examples of use

Getting the segment list

Method Objective

Syntax and parameters

API response

API Response Code

API Response Data

Request Example