---
title: "invoke-url | Customer's Canvas Hub"
canonical: "https://customerscanvas.com/docs/hub/printer-guide/pipelines/tasks/invoke-url/"
---

# invoke-url

> Learn how the invoke-url task transfers artifact data to external systems over HTTP.

This task transfers data to an external system via an HTTP request.

## Parameters

- `url` (string) - The address to which we send the request.
- `body` (object) - Defines the request body.
- `httpMethod` (string) - _(optional)_ The method of the HTTP request, one of `"GET"`, `"POST"`, `"PUT"`, or `"DELETE"`. If not provided, `"POST"` will be used by default.
- `queryHeaders` (object) - Arbitrary headers passed as a set of key-value pairs.
- `queryParameters` (object) - Arbitrary query parameters passed as a set of key-value pairs. 

:::note
We do not expect any response.

We can add arbitrary request headers.
:::

These parameters support [argument interpolation](https://customerscanvas.com/docs/hub/printer-guide/pipelines/concepts/interpolation.md) following the common rules.

## Example

```json
{
    "description": "Register print files with previews",
    "name": "register",
    "type": "invoke-url",
    "inputArtifacts": [
        "result*",
        "preview-front",
        "preview-back"
    ],
    "parameters": {
        "url": "https://example.com/",
        "httpMethod": "GET",
        "queryHeaders": {
            "accept": "application/json",
            "apiKeyHeader": "apikey",
            "someRandomHeader": "someRandomValue"
        },
        "queryParameters": {
            "projectId": "{{project.id}}",
            "sort": "descending"
        },
        "body": {
            "Id": "{{project.id}}",
            "front": {
                "file": "{{result1}}",
                "preview": "{{preview-front?}}"
            },
            "back": {
                "file": "{{result2}}",
                "preview": "{{preview-back?}}"
            }
        }
    }
}
```