---
title: "Forward message"
method: POST
path: "/message_forward"
tags: ["Message forward"]
---

# Forward message

`POST /message_forward`

Forward a message that has been generated by your own system to your
partner bank, CSM, or Swift network. The message is sent as is by
Mambu Payments (formerly Numeral).

Replaces `POST /message_forward/connected_accounts/...` (now
deprecated) with a body-based shape that additionally accepts an
optional `swift` block for Swift Business Connect overrides.

Per Swift channel, the override fields apply as follows:

| Field                  | swift_fin | swift_fileact | swift (InterAct) |
|------------------------|-----------|---------------|------------------|
| swift.receiver_bic     | ✅        |               |                  |
| swift.receiver_dn      |           | ✅            | ✅               |
| swift.service          |           | ✅            | ✅               |
| swift.message_type     | ✅        | ✅            | ✅               |
| swift.message_reference| ✅        | ✅            | ✅               |

## Request body

- object
  - `connected_account_id` string, uuid, required — The connected account to forward this message from.
  - `bank_service` 'bacs_direct_credit' | 'bacs_direct_debit' | 'chaps' | 'end_of_day_statements' | 'fps' | 'intra_day_statements' | 'sct' | 'sct_inst' | 'sdd' | 'swift' | 'swift_fin' | 'swift_fileact', required — The bank service to use. Must be enabled on the connected account.
  - `file_name` string, required — File name. Between 3 and 140 characters.
  - `content` string, byte, required — The file content, base64-encoded.
  - `swift` object — Optional Swift Business Connect overrides. Only valid when `bank_service` is `swift`, `swift_fin` or `swift_fileact`, and only the fields applicable to that channel are accepted (see the table above).
    - `receiver_bic` string — BIC8 or BIC11 of the receiver. Used for FIN messages.
    - `receiver_dn` string — Distinguished Name (DN) of the receiver in SwiftNet (InterAct/FileAct).
    - `service` string — Target Swift service code (InterAct/FileAct).
    - `message_type` string — Swift message type/identifier (FIN/InterAct/FileAct).
    - `message_reference` string — Sender reference set on the outbound Swift message (FIN/InterAct/FileAct).

## Response `200`

Successfully forwarded a message.

- ForwardedFileDetails — A file is received from or sent to a bank. A file can be a payment file, a payment status report, an account statement, etc.
  - `id` string, required — The UUID of the file.
  - `object` 'file', required — Label used to identify this kind of object.
  - `connected_account_id` string, uuid — The ID of the connected account used to send or receive the file.
  - `connected_account_ids` string[], required — The IDs of the connected accounts used to send the file. Contains only one entry.
  - `direction` 'outgoing', required — The transfer direction for the file_id: - `outgoing` for files sent or to be sent to the bank.
  - `category` 'forwarded_message', required — The category of the file.
  - `format` string, required — The format of the file.
  - `filename` string, required — The name of the file.
  - `size` integer, required — The size of the file, expressed in bytes.
  - `summary` object, required — A summary of the file, depending on its content.
  - `status` 'created' | 'approved' | 'canceled' | 'sent', required
  - `bank_data` object, required — Bank data, such as message ID, in JSON `key:value` format.
    - `message_ids` string[], required
  - `status_details` string, required — The details of the status of this file, such as the rejection reason for instance.
  - `created_at` string, date-time, required — The UTC timestamp of the creation of the file.

## Other responses

- `400` — Validation error.
- `401` — Unauthorized. API key is missing or invalid.
- `403` — Forbidden. Feature is not enabled for this API key.

---

[API](https://skmtc.net/numeral/apis/payments.md) · [All operations](https://skmtc.net/numeral/apis/payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/numeral/payments/revisions/220f101cc2ef/schema)