> For the complete documentation index, see [llms.txt](https://help.tillit.cloud/tillit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/integrations/wire-flow/task-types-and-integrations/external-integration.md).

# External Integration

Wire Flow external integration tasks for calling REST APIs from within a workflow using the HTTP Request node.

## HTTP Request

Calls an external REST API from within a workflow.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-1ee546c5c947ff5e2e3b5192178176e99d0b5a5e%2FPasted%20image%2020260414120904.png?alt=media" alt=""><figcaption></figcaption></figure>

| Field            | Description                                                                                 |
| ---------------- | ------------------------------------------------------------------------------------------- |
| **Method**       | GET, POST, PUT, PATCH, DELETE                                                               |
| **Endpoint URL** | Supports dynamic values: `https://api.example.com/orders/{$.body.id}`                       |
| **Request Body** | JSONPath to send a subset of the state (e.g., `$.body`). Leave empty to send the full state |
| **Credential**   | Select a saved credential for authentication                                                |

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-864935b2bdeb937944232423943942cf6ffb3376%2FPasted%20image%2020260414120942.png?alt=media" alt=""><figcaption></figcaption></figure>

The next task in the workflow receives the HTTP response in this format:

```json
{
  "statusCode": 200,
  "body": { }
}
```

Use `$states.input.body.<field>` in a downstream JSONata task to extract response values.

{% hint style="info" %}
HTTP tasks require a saved credential. If none is selected, Wire Flow uses a fallback method. Credentials are managed in the Secrets Manager — accessible from the Workflow List page or from the HTTP task's Properties Panel.
{% endhint %}