> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replyify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Forward Reply

> Forward a reply to another email address

Forward the reply content to one or more email addresses. Useful for escalating leads or sharing with team members outside of Replyify.

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier (UUID) of the reply
</ParamField>

## Request Body

<ParamField body="to" type="array" required>
  Array of email addresses to forward to
</ParamField>

<ParamField body="message" type="string">
  Optional message to include above the forwarded content
</ParamField>

<ParamField body="include_thread" type="boolean" default="true">
  Whether to include the full email thread in the forward
</ParamField>

## Response

<ResponseField name="data" type="object">
  Forward confirmation

  <Expandable>
    <ResponseField name="success" type="boolean">
      Whether the forward was successful
    </ResponseField>

    <ResponseField name="forwarded_to" type="array">
      List of email addresses the reply was forwarded to
    </ResponseField>

    <ResponseField name="forwarded_at" type="string">
      ISO timestamp when the forward was sent
    </ResponseField>
  </Expandable>
</ResponseField>

## Examples

### Basic Forward

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://app.replyify.ai/api/replies/abc123-def456-ghi789/forward" \
    -H "Authorization: Bearer rpl_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "to": ["sales@yourcompany.com"]
    }'
  ```

  ```javascript JavaScript theme={null}
  const replyId = 'abc123-def456-ghi789';
  const response = await fetch(
    `https://app.replyify.ai/api/replies/${replyId}/forward`,
    {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer rpl_your_api_key',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        to: ['sales@yourcompany.com']
      })
    }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  reply_id = 'abc123-def456-ghi789'
  response = requests.post(
      f'https://app.replyify.ai/api/replies/{reply_id}/forward',
      headers={'Authorization': 'Bearer rpl_your_api_key'},
      json={'to': ['sales@yourcompany.com']}
  )
  data = response.json()
  ```
</CodeGroup>

### Forward with Message

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://app.replyify.ai/api/replies/abc123-def456-ghi789/forward" \
    -H "Authorization: Bearer rpl_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "to": ["sales@yourcompany.com", "manager@yourcompany.com"],
      "message": "Hot lead - please follow up ASAP. They are interested in our enterprise plan.",
      "include_thread": true
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    `https://app.replyify.ai/api/replies/${replyId}/forward`,
    {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer rpl_your_api_key',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        to: ['sales@yourcompany.com', 'manager@yourcompany.com'],
        message: 'Hot lead - please follow up ASAP. They are interested in our enterprise plan.',
        include_thread: true
      })
    }
  );
  ```
</CodeGroup>

## Response Example

```json theme={null}
{
  "data": {
    "success": true,
    "forwarded_to": [
      "sales@yourcompany.com",
      "manager@yourcompany.com"
    ],
    "forwarded_at": "2024-01-15T17:00:00Z"
  }
}
```

## Errors

<ResponseField name="400 Bad Request">
  ```json theme={null}
  {
    "error": "At least one recipient email is required"
  }
  ```

  The `to` array is empty or missing.
</ResponseField>

<ResponseField name="400 Bad Request">
  ```json theme={null}
  {
    "error": "Invalid email address: invalid-email"
  }
  ```

  One or more email addresses in the `to` array are invalid.
</ResponseField>

<ResponseField name="404 Not Found">
  ```json theme={null}
  {
    "error": "Reply not found"
  }
  ```

  The specified reply ID doesn't exist in your workspace.
</ResponseField>

## Notes

<Info>
  Forwarding a reply triggers the `reply.forwarded` webhook event if you have webhooks configured.
</Info>

<Tip>
  Forwarding does not change the reply's status. You can still send a response to the original sender after forwarding.
</Tip>