Use the following instructions to create a step that makes a callout to a RESTful API.

When an API callout is made as part of a step and the callout does not succeed, the callout is placed in a queue and retried for 24 hours before failing.

1. Navigate to the definition where you will place this step.
2. In the Steps section, click the API Callout button.

If you already have steps in the definition, you can either use the New Child link next to the step name while viewing the definition or you can use the New Child Step button while viewing the existing step (towards the bottom of the page). Then change the Step Type in the Step Edit page to API Callout.

Complete the following fields:

• Step Name: Enter the name for this step. This field copies into the subject when the process executes.
• Step Type: Select API Callout.
• Parent Step: The parent step is the step that once completed initiates this new step. Leave it blank if this step must start with the process.
• Parent Stage: If a step has a parent stage, all steps in the parent stage must complete before this step creates.
• Definition: This is automatically populated based on the definition you started from.
• Stage: Select the stage, if any, this step should be associated with.
• Generate Step: Select to set up a task or custom object to generate when this callout occurs. The step options display.
• Perform Callout On: Select when a callout must made, such as when a step object is created, updated, or closed.
• Merge Fields: Use to populate the static and dynamic query parameters in the API Callout URL field. Click the Insert Field to URL or Insert Field to Request Body buttons to add your selections.
• API Callout URL: Select the static and dynamic query parameters (Merge Fields and Insert Field options) to populate the Uniform Resource Locator frame.

Make sure your API callout URL is set up as a remote site (Setup > Security > Remote Site Settings).

• API Callout Method: Select the HTTP verb to use for this callout. All standard callout verbs are available for use. The web service that you are calling specifies the verb to use for each method available in the service.
• API Callout Headers: Enter any HTTP headers to include in the callout. Headers must follow the standard header format with colon-separated header names and values. If you include multiple headers, separate them with semi-colons.
• API Callout Body: Enter the body to pass as part of the callout. When using the Body field, add a Content-Type header to the API Callout Headers field. For example, if you format the body as a JSON string, add the Content-Type: text/json header to the Headers field. In addition, include merge fields in the Body field. Select the desired object and field then click the Insert Field to Request Body button to insert them into the API Callout Body field.
• Delay Creation: If checked, Orchestrate delays creating this step until the day specified by the Delay Creation Date Adjustment. See Delayed Steps for more information.

Configure any needed step creation conditions.

See Step Creation Conditions for more information.

Click Save.