Lead Action

Leads must be enabled in your org. The user must have read and edit permissions for leads.

Supported REST HTTP Methods

URIs

Apply Lead Assignment Rules:

/services/data/vXX.X/actions/standard/invocableApplyLeadAssignmentRules

Formats

JSON, XML

HTTP Methods

GET, HEAD, POST

Authentication

Authorization: Bearer token

Other Information

Error Response Types

Apply Lead Assignment Rules

Run lead assignment rules on a collection of leads.

Available in API version 54.0.

URI: /services/data/vXX.X/actions/standard/invocableApplyLeadAssignmentRules

Sample Input

The following code runs lead assignment rules for two leads:

{"inputs": [ {
      "leadId" : "00QR00000006LE8OAM"
    },
    {
        "leadId" : "00QR00000006LEDOA2"
    }]
}

Sample Output

The following code sample illustrates a response when the action succeeds.

[ {
         "actionName" : "invocableApplyLeadAssignmentRules",
         "isSuccess" : true
         } ]

Error Response Types

Sales Engagement actions can respond with success or errors.

If any type of error occurs with an action, the isSuccess field is false.

This example illustrates an error caused when the user has insufficient access to leads when calling the Apply Lead Assignment Rules action.

[ {
  "actionName" : "invocableApplyLeadAssignmentRules",
  "errors" : [ {
    "statusCode" : "INSUFFICIENT_ACCESS_OR_READONLY",
    "message" : "Looks like you don't have access to this record. Your Salesforce admin can help with that.",
    "fields" : [ ]
  } ],
  "isSuccess" : false,
  "outputValues" : null
} ]

This example illustrates an error caused when the lead IDs passed to the Apply Lead Assignment Rules action are invalid.

[ {
  "actionName" : "invocableApplyLeadAssignmentRules",
  "errors" : [ {
    "statusCode" : "UNKNOWN_EXCEPTION",
    "message" : "Something's not right with one or more the specified LeadIds. Check the IDs and try again.",
    "fields" : [ ]
  } ],
  "isSuccess" : false,
  "outputValues" : null
} ]

This example illustrates an error caused when one of the leads passed to the Apply Lead Assignment Rules action has been deleted.

[ {
  "actionName" : "invocableApplyLeadAssignmentRules",
  "errors" : [ {
    "statusCode" : "ENTITY_IS_DELETED",
    "message" : "One or more of the specified LeadIds were deleted. Check the IDs and try again.",
    "fields" : [ ]
  } ],
  "isSuccess" : false,
  "outputValues" : null
} ]