Skip to main content
A ForwardingRequest is a one-time execution that securely forwards sensitive data to external APIs. It allows you to make outbound requests using templated values from Method resources (such as payment instruments, secrets, and entities) without exposing the underlying sensitive data. Template expressions use the {{binding_name.path.to.field}} syntax to reference values from bound resources.

​
ForwardingRequest Objects

{
  "id": "freq_f6xGfRQyQxDc",
  "bindings": {
    "payment_instrument": "pmt_inst_7TNTTRQwQxWc",
    "secret": "sec_au22b1fbFrmfp",
    "entity": "ent_au22b1FBFJbp8"
  },
  "request": {
    "url": "https://sample-url/v1/tokens",
    "method": "POST",
    "headers": {
      "Content-Type": "application/json",
      "Authorization": "Bearer {{secret.value}}"
    },
    "body": "{\"first_name\":\"John\",\"last_name\":\"Doe\",\"number\":\"{{payment_instrument.card.number}}\",\"month\":\"{{payment_instrument.card.month}}\",\"year\":\"{{payment_instrument.card.year}}\",\"cvv\":\"{{payment_instrument.card.cvv}}\",\"address1\":\"123 Main St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"country\":\"US\",\"postal_code\":\"94110\"}"
  },
  "response": {
    "status_code": 200,
    "headers": {
      "content-type": "application/json; charset=utf-8",
      "x-request-id": "3a92e6c6-7661-4270-bf31-2d4cc25ea911"
    },
    "body": {
      "type": "credit_card",
      "id": "vJlxp8rHhCq9FNCNF6VYeA",
      "card": {
        "brand": "visa",
        "first_six": "411111",
        "last_four": "1111",
        "exp_month": 2,
        "exp_year": 2030,
        "issuing_country": "US",
        "funding_source": "credit"
      }
    }
  },
  "duration_ms": 953,
  "created_at": "2025-12-04T18:50:54.024Z",
  "updated_at": "2025-12-04T18:50:54.024Z",
  "status": "completed"
}