---
title: "POST /didcomm/out-of-band/receive-invitation"
method: POST
path: "/didcomm/out-of-band/receive-invitation"
tags: ["DIDComm Out Of Band"]
---

# POST /didcomm/out-of-band/receive-invitation

`POST /didcomm/out-of-band/receive-invitation`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/didcomm/out-of-band/receive-invitation`
- Auth: none declared

Receive an out of band invitation. Supports urls as well as JSON messages. Also supports legacy
connection invitations

## Headers

- `x-tenant-id` string

## Request body

- DidCommOutOfBandReceiveInvitationOptions
  - `label` string
  - `alias` string
  - `imageUrl` string
  - `autoAcceptConnection` boolean
  - `autoAcceptInvitation` boolean
  - `reuseConnection` boolean
  - `acceptInvitationTimeoutMs` number, double
  - `ourDid` string
  - `invitation` union, required
    - PlaintextMessage
      - `@type` string, required
      - `@id` string, required
      - `~thread` object
        - `pthid` string
        - `thid` string
    - string

## Response `200`

Ok

- unknown

## Changes

- **2026-07-17** `33596742b733`: 2 info
  - the endpoint scheme security `tenants` was removed from the API
  - added the new optional `header` request parameter `x-tenant-id`
- **2024-03-27** `a7641432a6c1`: 1 warning, 1 info
  - deleted the `header` request parameter `x-tenant-id`
  - the endpoint scheme security `tenants` was added to the API

[Operation history](https://skmtc.dev/openwallet-foundation/apis/credo-rest-api/changes/didcomm/out-of-band/receive-invitation/post.md)

---

[API](https://skmtc.dev/openwallet-foundation/apis/credo-rest-api.md) - [All operations](https://skmtc.dev/openwallet-foundation/apis/credo-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openwallet-foundation/apis/credo-rest-api/revisions/33596742b733?raw)