Built-in workflow actions cover the most common operations, but sometimes you need to hit a specific endpoint or pass custom parameters that aren't available as a ready-made action. The Call API feature lets you make direct API calls to your connected integrations or external systems right inside a workflow.
Instead of waiting for native actions to be added, you can build custom actions yourself by adding a step that sends information to, or fetches information from, an outside system.
Understand the Call API actions
Depending on whether the app is already integrated with Atomicwork, you can choose between two types of API actions:
App-specific Call API action: Use this when you have already connected a supported app in Atomicwork and want to make a custom API call. These actions are available for supported connected integrations across categories such as identity, collaboration, HR, IT operations, security, and productivity apps. Authentication is handled automatically using your existing integration credentials.
Create a webhook action: Use this when you are calling a system that isn't installed as an Atomicwork integration, or when you need basic auth support only and not Oauth based integrations.
Use the app-specific Call API action
If you have already connected an app through the Atomicwork integrations page, you can leverage its specific Call API action to save time on authentication.
Navigate to Settings > Your workspace > Workflows.
Create a new workflow or select an existing one to edit.
Click Add an action to add a new step to your workflow.
Select the app you want to interact with (for example, Jira).
Choose the Call API action for that specific app.
Specify the API endpoint you want to hit and the data you want to send. Authentication is applied automatically.
You can also utilize the app-specific Call API action when you're writing a custom code block in a workflow.
Create a webhook for external services
For services not natively connected to Atomicwork, you can use the webhook action to configure the exact request details.
In your workflow builder, click Add an action.
Select Create a webhook.
Enter the web address (URL) of the external system where you want to send the request.
Choose the HTTP method to use. Select GET to read data, POST to create something, PUT or PATCH to update something, or DELETE to remove data.
Configure your authentication. You can pick from saved credentials, enter a username and password, provide an API token or key, or skip authentication if the endpoint does not require it.
Specify the data you want to include in the request body. You can pull in details from the request, such as the ticket subject or requester name.