Skip to end of banner
Go to start of banner

GET workflow_rules/trigger

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Available from CRM.COM R9.0.0

This method triggers an existing Workflow Rule. Only one Workflow rule can be triggered in each call.

Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

workflow_rule_identifier

(mandatory)

Workflow Rule Identifier

The identifier of the Workflow Rule that should be triggered. The allowed Workflow Rule request identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the Workflow Rule

number

(semi-optional)

String

The number of the Workflow Rule

name

(semi-optional)

StringThe name of the Workflow Rule

entity

(mandatory)

String

The name of the Entity with which the Workflow Rule is related to . The supported entities are the following:

  • ACTIVITIES
  • SERVICEREQUESTS
  • JOBS
  • SUBSCRIPTIONS
  • REWARDOFFERS
  • LEADS
  • REWARDOFFERS entity available from CRM.COM R11.0.0
  • LEADS entity available from CRM.COM R14.0.0

entity_id

(mandatory)

StringThe ID of the entity instance for which the Workflow Rule is enforced to be triggered.  

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

Name

Type

Description

entity

String

The name of the Entity for which the Workflow Rule was triggered . The supported entities are the following:

  • ACTIVITIES
  • SERVICEREQUESTS
  • JOBS
  • SUBSCRIPTIONS
  • REWARDOFFERS
  • LEADS
  • REWARDOFFERS entity available from CRM.COM R11.0.0
  • LEADS entity available from CRM.COM R14.0.0

entity_id

StringThe ID of the entity for which the Workflow Rule was triggered
workflow_ruleWorkflow rule ObjectThe Workflow Rule which was enforced to be triggered

 workflow_rule object response data

Name

Type

Description

id

String

The ID of the retrieved workflow rule

alternative_codeStringThe alternative code of the retrieved workflow rule
nameStringThe name of the retrieved workflow rule
life_cycle_stateString

The life cycle state of the retrieved workflow rule. The supported life cycle states are EFFECTIVE or NOT_EFFECTIVE

Examples

 Example 1

HTTP Method: GET

 

Request:

Response:

{
    "status":
    {
        "message": "",
        "description": "",
        "code": "OK"
    },
    "data":
    {
        "entity": "ACTIVITIES",
        "entity_id": "BCE90B30D846400383759910E7CE5D99",
        "workflow_rule":
        {
            "life_cycle_state": "EFFECTIVE",
            "id": "9E8A2D055DBA483F8978E5ACB0DE528B",
            "name": "Activity Rule Low",
            "alternative_code": "ACT_RULE_LOW"
        }
    }
} 
  • No labels