Launch a Workflow from an Attribute Source

post

https://na1.ironcladapp.com/public/api/v1/attribute-source/{sourceId}/launch

Launches a workflow from a source object using a pre-existing workflow sync mapping. Currently only supports Coupa and Salesforce.

OAuth Scope required: public.workflows.createFromSource

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

sourceId

string

required

The unique identifier of the attribute source configuration.

Query Params

externalId

string

Salesforce sources only. The Salesforce record ID. Not used for Coupa sources, which derive the external ID from the request body.

approvalType

string

enum

Coupa-specific parameter that determines the launch flow type.

Allowed:

Body Params

Headers

x-as-user-email

string

Denotes the actor of the request. When used, the API will take into account this user's permissions and access. This or x-as-user-id is required when the associated token was produced from the Client Credentials grant or with legacy bearer tokens on select endpoints. More information about permissions.

x-as-user-id

string

Denotes the actor of the request. When used, the API will take into account this user's permissions and access. This or x-as-user-email is required when the associated token was produced from the Client Credentials grant or with legacy bearer tokens on select endpoints. More information about permissions.

Responses

200Workflow created successfully, or a conflict was detected for Coupa sources.

202Soft launch failure — required fields are missing or invalid. The response includes a redirect URL to complete the launch manually.

400Bad request — missing externalId, invalid body, or other validation error.

401401