Step name (required)

An internal label for the workflow canvas, such as Notify Slack or Create lead in CRM.

API URL (required)

The full HTTPS endpoint to call. You can use HubSpot tokens, for example https://api.example.com/contacts/.

HTTP Method (required)

Choose from GET, POST, PUT, PATCH, or DELETE.

Authentication type (required)

Choose None, Bearer token, API key header, or Basic auth. The relevant credentials fields appear based on your selection.

Query parameters (optional)

Provide a JSON object of key-value pairs to append to the URL.

{
  "format": "json",
  "source": "hubspot"
}

Custom headers (optional)

Provide a JSON object of additional headers to include in the request.

{
  "X-Custom-Header": "my-value",
  "Content-Type": "application/json"
}

Request body (optional)

Used for POST, PUT, and PATCH requests. HubSpot workflow tokens can be inserted directly into the JSON.

{
  "email": "",
  "dealName": "{{deal.dealname}}",
  "stage": "{{deal.dealstage}}"
}

Timeout (optional)

Defaults to 10 seconds, with a maximum of 60 seconds.

After the action runs, these outputs are available in later workflow steps:

• status_code: The HTTP status code, such as 200, 404, or 500.
• response_body: The full response body as a string.
• success: true for 2xx responses, otherwise false.
• error_message: Error detail for timeouts, network issues, or failed responses.

Step name: Test
API URL: https://httpbin.org/get
HTTP Method: GET
Auth type: None

The app is installed via HubSpot's standard OAuth flow. No developer credentials or API keys on your side are required — authentication to your external APIs is configured per workflow step, not at install time.

1. Go to the HubSpot App Marketplace and search for Custom API Workflow Action.
2. Click Install app on the listing page.
3. You will be redirected to the King Henry authorisation page.
4. Review the requested permissions and click Connect app.
5. HubSpot will ask you to approve the scopes the app requires. Click Connect app on the HubSpot scope approval screen to grant access.
6. After approving, you are redirected back to HubSpot. The app will appear in Settings → Integrations → Connected Apps.

The OAuth authorisation step above connects your HubSpot account. No additional connection steps are needed after install — the app is immediately ready for use in workflows.

The app requests the automation scope only. This scope allows the app to register and execute workflow actions on your behalf. It does not grant access to your contacts, deals, or any other HubSpot data objects.

Disconnecting the app revokes the OAuth authorisation token between your HubSpot portal and King Henry. After disconnecting, any workflow that runs a Custom API Call step will fail because the action can no longer be executed.

To disconnect:

1. Go to Settings → Integrations → Connected Apps.
2. Find Custom API Workflow Action in the list.
3. Click Actions → Disconnect (or Uninstall, depending on your HubSpot version).
4. Confirm the disconnection in the dialog that appears.

What happens to your data: Disconnecting does not delete any HubSpot properties, workflow configurations, or enrolment history. No data stored in HubSpot is removed. King Henry does not retain any of your HubSpot data after disconnection. The app proxies API requests in real time and stores nothing.

Uninstalling fully removes the app from your HubSpot portal, including the OAuth connection and the registered workflow action type.

To uninstall:

1. Go to Settings → Integrations → Connected Apps.
2. Find Custom API Workflow Action in the list.
3. Click Actions → Uninstall.
4. Read the confirmation message and click Uninstall to confirm.

What happens to your data after uninstall:

• No HubSpot contacts, companies, deals, or other records are deleted.
• No HubSpot properties are deleted.
• Existing workflow steps that referenced the Custom API Call action remain in the workflow editor but are marked as inactive.
• Workflow enrolment history is preserved and still visible in HubSpot.
• King Henry does not store any of your HubSpot data, so there is nothing on King Henry’s side to delete.

You can reinstall the app at any time from the HubSpot App Marketplace. After reinstalling, existing workflow steps that referenced the action will become active again without reconfiguration.