> ## Documentation Index > Fetch the complete documentation index at: https://docs.leadvector.app/api-reference/llms.txt > Use this file to discover all available pages before exploring further. # Forward inbox message > Forwards an inbox message belonging to the authenticated API user. ## OpenAPI ````yaml /openapi.json post /v1/inbox/messages/{id}/forward openapi: 3.1.0 info: title: LeadVector API version: '1' description: >- Find and verify business emails and mobile numbers, enrich people and companies, and run your email campaigns, mailboxes and inbox. Send your API key in the `x-api-key` header. servers: - url: https://prod.leadvector.app description: Production security: - access-key: [] tags: - name: Authentication description: Check that an API key works. - name: Lookups description: >- Find business emails and mobile numbers, verify emails, and find the person behind an email. - name: Enrichment description: The full profile of a person or a company. - name: Campaigns description: Email campaigns and their sequences. - name: Leads description: A campaign's leads. - name: Email accounts description: The mailboxes campaigns send from, and their warmup. - name: Inbox description: Replies to your campaigns, in one inbox. - name: Webhooks description: Subscribe URLs to events, and read the events sent. - name: Campaign events description: >- A campaign's lifecycle: created, launched, paused, resumed, stopped, completed, deleted. - name: Lead events description: A lead joining a campaign, replying, being labelled, finishing or failing. - name: Email events description: Each step's email to a lead, sent or failed. - name: Inbox events description: Mail the inbox receives, and the replies and forwards sent from it. - name: Email account events description: A mailbox's connection, pause, cooldown, warmup health and deletion. - name: Lookup events description: >- A single lookup’s result, in the app, the extension or the API: an email or a mobile found, an email verified, a person or a company enriched. - name: Bulk job events description: A bulk job (a file of lookups) completing or failing. - name: List events description: A contact saved to one of the team’s lists. - name: Credit events description: The team’s credits running low, or out. - name: Test event description: The event an endpoint gets when you send it a test. paths: /v1/inbox/messages/{id}/forward: post: tags: - Inbox summary: Forward inbox message description: Forwards an inbox message belonging to the authenticated API user. operationId: ApiV1InboxController_forwardMessage parameters: - name: id required: true in: path description: Message identifier schema: type: number example: 1 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ForwardMessageDto' responses: '201': description: Inbox message forwarded successfully content: application/json: schema: $ref: '#/components/schemas/ForwardResponseDto' '400': description: >- Mailbox is not active, the id is not a number, or the body fails validation. content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponseDto' '401': description: API_KEY_REQUIRED / INVALID_API_KEY content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponseDto' '403': description: ACCOUNT_DEACTIVATED / TEAM_DEACTIVATED content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponseDto' '404': description: Mailbox message not found / Mailbox connection not found content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponseDto' '429': description: RATE_LIMIT_EXCEEDED, with a Retry-After header content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorResponseDto' security: - access-key: [] components: schemas: ForwardMessageDto: type: object properties: mailboxId: type: number example: 1 description: >- Mailbox to send the forward from; it must belong to the user and be active. Defaults to the mailbox that holds the message. toEmails: example: - jane.doe@northwind.example description: 'Who the message is forwarded to: one address or more.' type: array items: type: string format: email ccEmails: example: - sam@acme.example description: Copied on the forward. type: array items: type: string format: email bccEmails: example: - archive@acme.example description: Copied on the forward, unseen by the other recipients. type: array items: type: string format: email note: type: string maxLength: 5000 example: Jane asked about pricing; can you take this? description: A note placed above the forwarded message. required: - toEmails ForwardResponseDto: type: object properties: success: type: boolean example: true message: type: string example: Inbox message forwarded successfully data: $ref: '#/components/schemas/ForwardDataDto' required: - success - message - data ApiErrorResponseDto: type: object properties: statusCode: type: number example: 401 message: description: >- A code in capitals; the list of messages when the body fails validation; `Internal server error` for a 500. oneOf: - type: string - type: array items: type: string example: INVALID_API_KEY error: type: string description: The status's name. example: Unauthorized traceId: type: string description: Quote it when you contact support. example: 4f1c2b7e9a0d4c3b8e6f5a2d1c0b9e8f timestamp: type: string example: '2026-11-03T09:41:12.000Z' path: type: string example: /v1/find-email required: - statusCode - message - traceId - timestamp - path RateLimitErrorResponseDto: type: object properties: statusCode: type: number example: 401 message: description: The error's code. oneOf: - type: string - type: array items: type: string example: RATE_LIMIT_EXCEEDED error: type: string description: The status's name. example: Unauthorized traceId: type: string description: Quote it when you contact support. example: 4f1c2b7e9a0d4c3b8e6f5a2d1c0b9e8f timestamp: type: string example: '2026-11-03T09:41:12.000Z' path: type: string example: /v1/find-email limit: type: number description: Calls allowed per window. example: 10 windowSeconds: type: number example: 60 retryAfterSeconds: type: number description: Seconds until the next call is allowed. example: 6 required: - statusCode - message - traceId - timestamp - path - limit - windowSeconds - retryAfterSeconds ForwardDataDto: type: object properties: message: type: string example: Email forwarded successfully data: $ref: '#/components/schemas/ForwardedMessageDto' required: - message - data ForwardedMessageDto: type: object properties: id: type: number example: 981 providerMessageId: example: 18c3f2… type: - string - 'null' providerThreadId: example: 18c3f0… type: - string - 'null' toEmails: example: - jane.doe@northwind.example type: array items: type: string subject: type: string example: 'Fwd: Quick question' sentAt: format: date-time type: - string - 'null' required: - id - providerMessageId - providerThreadId - toEmails - subject - sentAt securitySchemes: access-key: type: apiKey in: header name: x-api-key description: Your API key, from the API keys page of the app. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.