Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Tip

Available from CRM.COM R4.0.0

 

Table of Contents
maxLevel2

GET activities/show

This method returns information related with an activity.  Single activity is returned by each call

Resource URL

Parameters

...

Name

...

Type

...

Description

...

token

...

String

...

The token retrieved from the login method

...

(mandatory)

...

Activity identifier  

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

...

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
titleExample 1

HTTP Method: GET

 

Request:

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 

GET activities/list

This method returns information related with activities. Multiple activities are returned by each call

Resource URL

Parameters

...

Name

...

Type

...

Description

...

token

...

String

...

The token retrieved from the login method

...

(semi-optional)

...

Activity type identifier  

The identifier of the activity type. The allowed activity type identifier fields are the following:

...

(semi-optional)

...

The identifier of the contact information related with the account that will be returned as results. The allowed contact information identifier fields are the following:

...

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
titleExample 1

HTTP Method: GET

 

Request:

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 

POST activities/create

...

Tip

Available from CRM.COM R4.0.0

 

Table of Contents
maxLevel2

GET rewards_participants/show

This method returns information related with a rewards participants. A single rewards participant is returned by each call

Resource URL

Parameters

typeActivity Type Identifier type activity activity type identifiers activitytypeactivitytypecontactinformation_identifier mandatory)The contact information related with the activity. The allowed contact information identifiers are the following:

Name

Type

Description

token

String

The token retrieved from the login method

rewards_participant_identifier

(mandatory)

Rewards Participant identifier  

The

identifier of the

rewards participant that should be returned as a result. The allowed

rewards participant identifier fields are the following:

Include Page
V4:

rewards_

participant_identifier
V4:

rewards_

participant_identifier

fields_

set

(

Contact Information Identifier

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:

...

rewards_

...

participant_

...

complete
V4:

...

rewards_

...

participant_

...

category_identifier

(optional)

...

The category of the activity. The allowed activity category identifiers are the following:

...

status_identifier

(mandatory)

...

The status of the activity. The allowed activity status identifiers are the following:

...

description

(optional)

...

notes

(optional)

...

start_date

(optional)

...

owned_by_group_identifier

(mandatory)

...

complete

Examples

Expand
titleExample 1

HTTP Method: GET

 

Request:

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 

GET rewards_participants/list

This method returns information related with rewards participants. Multiple rewards participants are returned by each call

Resource URL

Parameters

level_identifierThe privacy level of the activity. The allowed privacy level identifier fields are the following:

Name

Type

Description

token

String

The token retrieved from the login method

accounts_receivable_identifier

(semi-optional)

Accounts Receivable identifier  

The identifier of the accounts receivable related with the rewards participant that should be returned as a result. The allowed accounts receivable identifier fields are the following:

Include Page
V4:accounts_receivable_identifier
V4:accounts_receivable_identifier

contact_information_identifier

(semi-optional)

Contact Information identifier  

The identifier of the contact information related with the rewards participant that should be returned as a result. The allowed contact information identifier fields are the following:

Include Page
V4:groupcontact_information_identifier
V4:groupcontact_information_identifier
privacy

fields_

set

(optional)

The identifier of the privacy level

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:

...

rewards_

...

participant_

...

complete
V4:

...

rewards_

...

udf_string_3 

(optional)

...

User Defined Field of type String

...

udf_string_4 

(optional)

...

User Defined Field of type String

...

udf_string_5

(optional)

...

User Defined Field of type String

...

udf_string_6 

(optional)

...

User Defined Field of type String

...

udf_string_7

(optional)

...

User Defined Field of type String

...

udf_string_8

(optional)

...

User Defined Field of type String

...

udf_float_1

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_2

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_3

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_4

(optional)

...

Float

...

User Defined Field of type Float

...

udf_date_1 

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_2 

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_3

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_4

(optional)

...

Date

...

User Defined Field of type Date

...

expected_completion_date

(semi-optional)

...

estimate_completion_time

(semi-optional)

...

assign_to

(mandatory)

...

The assignment information of the activity

...

performed_for

(optional)

...

The entities which are related with the activity

...

services_to_be_provided_set

(optional)

...

The information related to the services to be provided with the activity

 

...

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
titleExample 1

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 

 

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 

POST activities/update

This method updates activities.  Single activities can be updated by each call. Fields which are not specified are not updated at all. Fields which are specified as null will be set as null.

Resource URL

Parameters

...

Name

...

Type

...

Description

...

token

...

String

...

The token retrieved from the login method

...

activity_identifier

(mandatory)

...

The identifier of the account receivable to be updated. The allowed account receivable identifier fields are the following:

...

category_identifier

(optional)

...

The category of the activity. The allowed activity category identifiers are the following:

...

status_identifier

(optional)

...

The status of the activity. The allowed activity status identifiers are the following:

...

description

(optional)

...

notes

(optional)

...

start_date

(optional)

...

owned_by_group_identifier

(optional)

...

participant_complete

Examples

Expand
titleExample 1

HTTP Method: GET

 

Request:

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 

POST rewards_participants/create

This method creates a rewards participant.  Single rewards participants can be created by each call.

Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

sign_up_on

(mandatory)

DateThe date that the rewards participant signed up

sign_up_by_unit_identifier

(mandatory)

Unit identifier

The unit that signed up the rewards participant. The allowed unit identifier fields are the following:

Include Page
V4:unit_identifier
V4:unit_identifier

udf_string_3 

(optional)

String

User Defined Field of type String

udf_string_4 

(optional)

String

User Defined Field of type String

udf_string_5

(optional)

String

User Defined Field of type String

udf_string_6 

(optional)

String

User Defined Field of type String

udf_string_7

(optional)

String

User Defined Field of type String

udf_string_8

(optional)

String

User Defined Field of type String

udf_float_1

(optional)

Float

User Defined Field of type Float

udf_float_2

(optional)

Float

User Defined Field of type Float

udf_float_3

(optional)

Float

User Defined Field of type Float

udf_float_4

(optional)

Float

User Defined Field of type Float

udf_date_1 

(optional)

Date

User Defined Field of type Date

udf_date_2 

(optional)

Date

User Defined Field of type Date

udf_date_3

(optional)

Date

User Defined Field of type Date

udf_date_4

(optional)

Date

User Defined Field of type Date

accounts_receivable

(mandatory)

Accounts receivable objectThe accounts receivable owned by the reward participant that identifies the CRM.COM customer, and handles all financial transactions that might be posted as a result of award or spend reward transactions

participating_schemes_set

(optional)

Set of Rewards Participant Scheme ObjectsA list of reward schemes that the rewards participant has joint

Anchor
rewards participant create referred objects parameters
rewards participant create referred objects parameters
Referred Parameters Objects Data

Include Page
V4:accounts_receivable_parameters
V4:accounts_receivable_parameters

Include Page
V4:rewards_participant_schemes_parameter
V4:rewards_participant_schemes_parameter

 

 

 

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:rewards_participant_complete
V4:rewards_participant_complete

Examples

Expand
titleExample 1

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 

 

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 

POST rewards_participants/update

This method updates reward participants. A single rewards participant can be updated by each call. Fields which are not specified are not updated at all. Fields which are specified as null will be set as null.

Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

rewards_participant_identifier

(mandatory)

Rewards Participant identifier  

The identifier of the rewards participant that should be updated. The allowed rewards participant identifier fields are the following:

Include Page
V4:grouprewards_participant_identifier
V4:grouprewards_participant_identifier
privacy_level

sign_up_on

(optional)

DateThe date that the rewards participant signed up

sign_up_by_unit_identifier

(optional)

The Unit identifier of the privacy level

The privacy level of the activityunit that signed up the rewards participant. The allowed privacy level unit identifier fields are the following:

Include Page
V4:privacy_levelunit_identifier
V4:privacy_levelunit_identifier

udf_string_3 

(optional)

String

User Defined Field of type String

udf_string_4 

(optional)

String

User Defined Field of type String

udf_string_5

(optional)

String

User Defined Field of type String

udf_string_6 

(optional)

String

User Defined Field of type String

udf_string_7

(optional)

String

User Defined Field of type String

udf_string_8

(optional)

String

User Defined Field of type String

udf_float_1

(optional)

Float

User Defined Field of type Float

udf_float_2

(optional)

Float

User Defined Field of type Float

udf_float_3

(optional)

Float

User Defined Field of type Float

udf_float_4

(optional)

Float

User Defined Field of type Float

udf_date_1 

(optional)

Date

User Defined Field of type Date

udf_date_2 

(optional)

Date

User Defined Field of type Date

udf_date_31 

(optional)

Date

User Defined Field of type Date

udf_date_42 

(optional)

Date

User Defined Field of type Date

expected_completion_date

(optional)

DateThe date that the activity is expected to be completed

estimate_completion_time

(optional)

Time Period ObjectThe time that is estimated to complete the activity, measured in minutes, hours, days, weeks, years

assign_toudf_date_3

(optional)

Assign To Object

The assignment information of the activity

performed_forDate

User Defined Field of type Date

udf_date_4

(optional)

Performed for Object

The entities which are related with the activity

 

services_to_be_providedDate

User Defined Field of type Date

participating_schemes_set

(optional)

Set of Services to be Provided ObjectThe information related to the services to be provided with the activityRewards Participant Scheme Objects

A list of reward schemes that the rewards participant has joint

Include Page
V4:Web API - Updating Sets
V4:Web API - Updating Sets

...

Anchor
rewards participant update referred objects parameters
rewards participant update referred objects parameters
Referred Parameters Objects Data

 

Include Page
V4:activityrewards_services_to_be_providedparticipant_schemes_update_parameter
V4:activityrewards_servicesparticipant_toschemes_be_provided_update_parameter

Restrictions

...

Response Data

Include Page
V4:activitiesrewards_participant_complete
V4:activitiesrewards_participant_complete

Examples

Expand
titleExample 1

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue