Tip
Available from CRM.COM R5.0.0

Table of Contents

maxLevel	2

...

Name

Type

Description

token

String

The token retrieved from the login method

access_token_identifier

(mandatory)

Access Token identifier

The identifier of the access token that should be returned as a result. The allowed access token identifier fields are the following:

Include Page

	V4:access_token_identifier
	V4:access_token_identifier

fields_set

(optional)

List of Strings, comma separated

A list of fields that should be included in the results. If not specified then all the available fields will be returned

...

Expand

title	Example 1

HTTP Method: GET

Request:

Response:

Code Block

theme	Confluence
language	javascript
linenumbers	true

GET access_tokens/get_not_associated

This method returns all the access tokens which are not associated with an existing entity. Multiple access tokens are retrieved by each call

Resource URL

Parameters

Name	Type	Description
token	String	The token retrieved from the login method
number (mandatory)	Number	The number of access tokens that should be retrieved
life_cycle_state (optional)	String	The life cycle state of the access tokens that should be retrieved. The allowed options are EFFECTIVE or NOT_EFFECTIVE
fields_set (optional)	List of Strings, comma separated	A list of fields that should be included in the results. If not specified then all the available fields will be returned

Restrictions

It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

Response Data

...

Examples

Expand

title	Example 1

HTTP Method: GET

Request:

Response:

Code Block

theme	Confluence
language	javascript
linenumbers	true

POST access_tokens/create

This method creates an access token. Single access tokens can be created by each call.

Resource URL

Parameters

Name	Type	Description
token	String	The token retrieved from the login method
authentication_code (optional)	String	The authentication code of the access token that will be created. If not specified then it will be generated automatically.
identifier (mandatory on conditions)	String	The identifier of the access token that will be created. This information is not mandatory if the system is set up to allow creating access tokens with no identifier and pass code.
pass_code (mandatory on conditions)	String	The pass code of the access token that will be created. This information is not mandatory if the system is set up to allow creating access tokens with no identifier and pass code, although it is always mandatory if an identifier was specified.

Restrictions

It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

Response Data

...

Examples

Expand

title	Example 1

HTTP Method: POST

Request:

Body:

Code Block

theme	Confluence
language	javascript
linenumbers	true

Response:

Code Block

theme	Confluence
language	javascript
linenumbers	true

 {
    "status":
    {
        "message": null,
        "description": null,
        "code": "OK"
    },
    "data":
    {
        "log_information":
        {
            "updated_date": "2014-12-01T14:49:01",
            "created_by_unit":
            {
                "community_name": "Main Community",
                "group_name": "Main Group",
                "name": "Admin Unit",
                "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                "description": "r1",
                "alternative_code": "MG"
            },
            "created_date": "2014-12-01T14:41:53",
            "updated_by_unit":
            {
                "community_name": "Main Community",
                "group_name": "Main Group",
                "name": "Admin Unit",
                "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                "description": "r1",
                "alternative_code": "MG"
            },
            "created_by_user":
            {
                "person_name": "MPAdministrator",
                "username": "MPAdministrator",
                "id": "1",
                "email": "mp@ministrator.com"
            },
            "updated_by_user":
            {
                "person_name": "MPAdministrator",
                "username": "MPAdministrator",
                "id": "1",
                "email": "mp@ministrator.com"
            }
        },
        "reward_participant":
        {
            "accounts_receivable":
            {
                "account_owner":
                {
                    "last_name": "Marios",
                    "life_cycle_state": "FINANCIAL",
                    "middle_name": null,
                    "company_profile": null,
                    "title": null,
                    "type": "PERSON",
                    "first_name": "Ioannou",
                    "name": null,
                    "id": "B8C601694611DE7ECC29B232AB38D80A",
                    "company_name": null,
                    "demographics":
                    {
                        "gender": "MALE",
                        "passport_issued_by_country": null,
                        "passport_number": null,
                        "social_security_number": null,
                        "country_of_residence": null,
                        "industry_sector": null,
                        "date_of_birth":
                        {
                            "month": null,
                            "day": null,
                            "year": null
                        },
                        "name_day":
                        {
                            "month": null,
                            "day": null
                        },
                        "id_number": null,
                        "id_issued_by_country": null,
                        "industry": null
                    }
                },
                "life_cycle_state": "ACTIVE",
                "number": "000001",
                "name": "Photos Panayi",
                "id": "23E6B215D4ED39080314212774711C95"
            },
            "number": "1",
            "id": "FF8DBE4ED93CCD249BEA7A8758E9DE1F"
        },
        "authentication_code": "replace",
        "life_cycle_state": "EFFECTIVE",
        "identifier": "replace",
        "number": "10",
        "id": "F87296F4640D8261183FD93240B21448"
    }
}

GET access_tokens/get_not_associated

This method returns all the access tokens which are not associated with an existing entity. Multiple access tokens are retrieved by each call

Resource URL

Parameters

Name	Type	Description
token	String	The token retrieved from the login method
number (mandatory)	Number	The number of access tokens that should be retrieved
life_cycle_state (optional)	String	The life cycle state of the access tokens that should be retrieved. The allowed options are EFFECTIVE or NOT_EFFECTIVE
fields_set (optional)	List of Strings, comma separated	A list of fields that should be included in the results. If not specified then all the available fields will be returned

Restrictions

It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

Response Data

Include Page

	V4:access_token_complete
	V4:access_token_complete

Examples

Expand

title	Example 1

HTTP Method: GET

Request:

Response:

Code Block

theme	Confluence
language	javascript
linenumbers	true

{
    "status":
    {
        "message": null,
        "description": null,
        "code": "OK"
    },
    "data":
    [
        {
            "log_information":
            {
                "updated_date": "2014-12-01T15:08:48",
                "created_by_unit":
                {
                    "community_name": "Main Community",
                    "group_name": "Main Group",
                    "name": "Admin Unit",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "description": "r1",
                    "alternative_code": "MG"
                },
                "created_date": "2014-12-01T15:06:49",
                "updated_by_unit":
                {
                    "community_name": "Main Community",
                    "group_name": "Main Group",
                    "name": "Admin Unit",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "description": "r1",
                    "alternative_code": "MG"
                },
                "created_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "mp@ministrator.com"
                },
                "updated_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "mp@ministrator.com"
                }
            },
            "reward_participant": null,
            "authentication_code": "testdelete",
            "life_cycle_state": "EFFECTIVE",
            "identifier": "delete",
            "number": "12",
            "id": "5AD209B9163C9C47BBF1991F52CF0A6B"
        },
        {
            "log_information":
            {
                "updated_date": "2014-12-01T17:08:47",
                "created_by_unit":
                {
                    "community_name": "Main Community",
                    "group_name": "Main Group",
                    "name": "Admin Unit",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "description": "r1",
                    "alternative_code": "MG"
                },
                "created_date": "2014-12-01T16:56:49",
                "updated_by_unit":
                {
                    "community_name": "Main Community",
                    "group_name": "Main Group",
                    "name": "Admin Unit",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "description": "r1",
                    "alternative_code": "MG"
                },
                "created_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "mp@ministrator.com"
                },
                "updated_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "mp@ministrator.com"
                }
            },
            "reward_participant": null,
            "authentication_code": "apitestn",
            "life_cycle_state": "EFFECTIVE",
            "identifier": "apit55",
            "number": "16",
            "id": "CB5B6BCD02783D5ED432789D6AA965EE"
        },
        {
            "log_information":
            {
                "updated_date": "2014-12-01T17:15:55",
                "created_by_unit":
                {
                    "community_name": "Main Community",
                    "group_name": "Main Group",
                    "name": "Admin Unit",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "description": "r1",
                    "alternative_code": "MG"
                },
                "created_date": "2014-12-01T17:15:39",
                "updated_by_unit":
                {
                    "community_name": "Main Community",
                    "group_name": "Main Group",
                    "name": "Admin Unit",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "description": "r1",
                    "alternative_code": "MG"
                },
                "created_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "mp@ministrator.com"
                },
                "updated_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "mp@ministrator.com"
                }
            },
            "reward_participant": null,
            "authentication_code": "notassociated",
            "life_cycle_state": "NOT_EFFECTIVE",
            "identifier": "nota",
            "number": "17",
            "id": "0453B38E3BD7CAAC90316FCACCDE63E8"
        },
        {
            "log_information":
            {
                "updated_date": "2014-12-02T09:13:24",
                "created_by_unit":
                {
                    "community_name": "Main Community",
                    "group_name": "Main Group",
                    "name": "Admin Unit",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "description": "r1",
                    "alternative_code": "MG"
                },
                "created_date": "2014-12-02T09:13:24",
                "updated_by_unit":
                {
                    "community_name": "Main Community",
                    "group_name": "Main Group",
                    "name": "Admin Unit",
                    "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                    "description": "r1",
                    "alternative_code": "MG"
                },
                "created_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "mp@ministrator.com"
                },
                "updated_by_user":
                {
                    "person_name": "MPAdministrator",
                    "username": "MPAdministrator",
                    "id": "1",
                    "email": "mp@ministrator.com"
                }
            },
            "reward_participant": null,
            "authentication_code": "apitest",
            "life_cycle_state": "EFFECTIVE",
            "identifier": "apitest",
            "number": "18",
            "id": "DC99E46BAFD6A0316D13DB69E5A5F964"
        }
    ]
}

POST access_tokens/create

This method creates an access token. Single access tokens can be created by each call.

Resource URL

Parameters

Name	Type	Description
token	String	The token retrieved from the login method
authentication_code (optional)	String	The authentication code of the access token that will be created. If not specified then it will be generated automatically.
identifier (mandatory on conditions)	String	The identifier of the access token that will be created. This information is not mandatory if the system is set up to allow creating access tokens with no identifier and pass code.
pass_code (mandatory on conditions)	String	The pass code of the access token that will be created. This information is not mandatory if the system is set up to allow creating access tokens with no identifier and pass code, although it is always mandatory if an identifier was specified.

Restrictions

It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

Response Data

Include Page

	V4:access_token_complete
	V4:access_token_complete

Examples

Expand

title	Example 1

HTTP Method: POST

Request:

Body:

Code Block

theme	Confluence
language	javascript
linenumbers	true

{
       "token":"15AA5D8C471CCE60AE434A5C864E2A51",
       "authentication_code":"apitest",
       "identifier":"apitest",
       "pass_code":"api11112"
}

Response:

Code Block

theme	Confluence
language	javascript
linenumbers	true

{
    "status":
    {
        "message": null,
        "description": null,
        "code": "OK"
    },
    "data":
    {
        "log_information":
        {
            "updated_date": "2014-12-02T09:13:24",
            "created_by_unit":
            {
                "community_name": "Main Community",
                "group_name": "Main Group",
                "name": "Admin Unit",
                "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                "description": "r1",
                "alternative_code": "MG"
            },
            "created_date": "2014-12-02T09:13:24",
            "updated_by_unit":
            {
                "community_name": "Main Community",
                "group_name": "Main Group",
                "name": "Admin Unit",
                "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                "description": "r1",
                "alternative_code": "MG"
            },
            "created_by_user":
            {
                "person_name": "Marios Lannister",
                "username": "MPAdministrator",
                "id": "1",
                "email": null
            },
            "updated_by_user":
            {
                "person_name": "Marios Lannister",
                "username": "MPAdministrator",
                "id": "1",
                "email": null
            }
        },
        "reward_participant": null,
        "authentication_code": "apitest",
        "life_cycle_state": "EFFECTIVE",
        "identifier": "apitest",
        "number": "18",
        "id": "DC99E46BAFD6A0316D13DB69E5A5F964"
    }
}

POST access_tokens/update

...

Name

Type

Description

token

String

The token retrieved from the login method

access_token_identifier

(mandatory)

Access Token identifier

The identifier of the access token that should be updated. The allowed access token identifier fields are the following:

Include Page

	V4:access_token_identifier
	V4:access_token_identifier

authentication_code

(optional)

String

The authentication code of the access token that will be updated. Is specified as null then the authentication code will be regenerated automatically

identifier

(mandatory on conditions)

String

The identifier of the access token that will be update. This information is not mandatory if the system is set up to allow creating access tokens with no identifier and pass code.

pass_code

(mandatory on conditions)

String

The pass code of the access token that will be updated. This information is not mandatory if the system is set up to allow creating access tokens with no identifier and pass code, although it is always mandatory if an identifier was specified.

...

Versions Compared

Old Version 5

New Version 6

Key

GET access_tokens/get_not_associated

Resource URL

Parameters

Restrictions

Response Data

Examples

POST access_tokens/create

Resource URL

Parameters

Restrictions

Response Data

Examples

GET access_tokens/get_not_associated

Resource URL

Parameters

Restrictions

Response Data

Examples

POST access_tokens/create

Resource URL

Parameters

Restrictions

Response Data

Examples

POST access_tokens/update

Page Comparison

Versions Compared

Old Version 5

New Version 6

Key

GET access_tokens/get_not_associated

Resource URL

Parameters

Restrictions

Response Data

Examples

POST access_tokens/create

Resource URL

Parameters

Restrictions

Response Data

Examples

GET access_tokens/get_not_associated

Resource URL

Parameters

Restrictions

Response Data

Examples

POST access_tokens/create

Resource URL

Parameters

Restrictions

Response Data

Examples

POST access_tokens/update