# Forwards

This API allows you to manage forwarding of incoming emails.

 - [GET /v3/forwards/{id}](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/forwards/get-v3-forwards--id-.md): Retrieve a forward rule by ID
 - [PUT /v3/forwards/{id}](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/forwards/put-v3-forwards--id-.md): All parameters are optional; only the provided fields will be updated. Submit an explicit empty value for `forward.recipient` or `forward.url` to clear that destination type. A rule must retain at lea
 - [DELETE /v3/forwards/{id}](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/forwards/delete-v3-forwards--id-.md): By default this call is scoped to the entire account. You can scope the request by providing the 'domain.name' query parameter. If the 'domain.name' parameter is provided and the requested rule is not
 - [GET /v3/forwards](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/forwards/get-v3-forwards.md): By default this endpoint lists all rules defined on the account. You can scope the list of rules by domain with 'domain.name', or search match expressions and forwarding destinations with 'search'. Re
 - [POST /v3/forwards](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/forwards/post-v3-forwards.md): ### Examples You can add multiple email recipients by including the 'forward.recipient' parameter multiple times up to a maximum of 5. ``` $ curl -X POST https://api.mailgun.net/v3/forwards -F matc