---
title: "Invoke an outbound proxy connection"
method: POST
path: "/token/connections/{connectionId}/proxy"
tags: ["Vault Proxy Connections"]
---

# Invoke an outbound proxy connection

`POST /token/connections/{connectionId}/proxy`

Proxies an outbound request to the destination using the provided headers. Please note that you can configure
connection using any of HTTP methods, not only POST.

## Path parameters

- `connectionId` string, uuid, required

## Headers

- `Payrails-Authorization` string, required
- `Payrails-Destination` string, required — Target endpoint URL.

## Response `200`

Returns the response from the destination URL.
Although it was demonstrated to return raw data, the raw response is passed to the proxy merchant, which aligns with the real-world use case.
In a real scenario, the merchant would not return actual card data — this is just a sample response to demonstrate the proxy use case.

## Other responses

- `413` — Content Too Large.

---

[API](https://skmtc.net/payrails/apis/payrails-api-reference.md) · [All operations](https://skmtc.net/payrails/apis/payrails-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payrails/payrails-api-reference/versions/9dd2f0158582/schema)
