---
title: "Receive an inbound Swift message"
method: POST
path: "/webapi/inbound-messages"
tags: ["Inbound Messages"]
---

# Receive an inbound Swift message

`POST /webapi/inbound-messages`

## Request

- Base URL: `https://your-environment.appiancloud.com/suite`
- URL: `https://your-environment.appiancloud.com/suite/webapi/inbound-messages`
- Auth: API key in header `appian-api-key`
- TypeScript: <https://skmtc.dev/appian/apis/appian-adapter-for-swift-api/docs/webapi/inbound-messages/post.ts> (a function with typed inputs; its response is checked against the schema)

Receives a raw Swift MT or MX message for validation, parsing, and conversion
into a structured Appian data object. The message is processed asynchronously.
Use the returned `messageId` to poll for processing status.

## Request body

- InboundMessageRequest
  - `content` string, required: The raw Swift message content. For MT messages, this is the full FIN message string including all blocks (1-5). For MX messages, this is the XML content.
  - `timestamp` string, date-time, required: ISO 8601 timestamp of when the message was sent by the source system.
  - `source` string, required: Identifier of the source system sending the message.
  - `sourceFields` object[], required: Additional metadata key-value pairs from the source system. Must not be empty.
  - `validateBic` boolean: Whether to validate BIC codes in the message against the BIC reference database. Set to `false` if BIC validation is not required or BIC data has not been ingested.

## Response `200`

Message received and queued for processing.

- InboundMessageResponse
  - `messageId` string, uuid: The unique identifier assigned to the received message.
  - `status` 'INBD_STTS_RCVD' | 'INBD_STTS_ERR-001' | 'INBD_STTS_ERR-004': The status of the message upon receipt. Possible values: - `INBD_STTS_RCVD`: Message received successfully. - `INBD_STTS_ERR-001`: Error persisting message or starting processing. - `INBD_STTS_ERR-004`: Request body was empty.

## Other responses

- `400`: Bad request. The payload is empty or malformed.
- `401`: Unauthorized. Invalid or missing API key.
- `500`: Internal server error.

---

[API](https://skmtc.dev/appian/apis/appian-adapter-for-swift-api.md) - [All operations](https://skmtc.dev/appian/apis/appian-adapter-for-swift-api/llms.txt) - [OpenAPI document](https://skmtc.dev/appian/apis/appian-adapter-for-swift-api/revisions/e569d9171a33?raw)