Overview
The API Request step lets you call any external API or web service. Configure the method, URL, headers, authentication, and body to integrate with third-party services or internal APIs.
Configuration
| Field | Options |
|---|
| Method | GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS |
| URL | Target endpoint (supports template variables) |
| Headers | Key-value header pairs |
| Query Params | Key-value query parameters |
| Auth | None, Basic Auth, Bearer Token, API Key, OAuth2, Royaltyport API |
| Body | None, Text (JSON / XML / Raw), or Form (with multipart toggle) |
Authentication
Select an auth type to attach credentials from your secrets to the request:
| Auth Type | Description |
|---|
| None | No authentication |
| Basic Auth | HTTP basic authentication (username + password) |
| Bearer Token | Bearer token in the Authorization header |
| API Key | Custom API key header |
| OAuth2 | OAuth2 client credentials flow |
| Royaltyport API | Built-in authentication for the Royaltyport REST API |
Royaltyport API
The Royaltyport API auth type lets you call the Royaltyport REST API directly from your automations without managing tokens or secrets. Authentication is handled automatically using your project’s internal credentials — no setup required.
Select Royaltyport API from the auth dropdown and point the URL at any https://api.royaltyport.com/v1/ endpoint. The step injects the correct authorization headers at runtime.
To get started quickly, use one of the built-in Royaltyport presets:
| Preset | Endpoint |
|---|
| Royaltyport — List Projects | GET /v1/projects |
| Royaltyport — Get Project | GET /v1/projects/:id |
| Royaltyport — Search Project | GET /v1/projects/:id/search |
| Royaltyport — List Contracts | GET /v1/contracts |
| Royaltyport — Get Contract | GET /v1/contracts/:id |
| Royaltyport — List Entities | GET /v1/entities |
| Royaltyport — Get Entity | GET /v1/entities/:id |
| Royaltyport — List Artists | GET /v1/artists |
| Royaltyport — Get Artist | GET /v1/artists/:id |
| Royaltyport — List Writers | GET /v1/writers |
| Royaltyport — Get Writer | GET /v1/writers/:id |
Presets fill in the URL, headers, and auth automatically. Combine them with trigger data like {{trigger.contract_id}} to make them dynamic.
Body Types
| Type | Description |
|---|
| None | No request body (typically for GET requests) |
| Text | Raw text body with format selector (JSON, XML, or Raw) |
| Form | Form data with key-value pairs and optional multipart toggle for file uploads |
Output
| Field | Type | Description |
|---|
status | number | HTTP status code |
headers | object | Response headers |
body | any | Response body |
error | boolean | Whether an error occurred |
error_message | string | Error description if failed |
