# Create a forward rule

### 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 match='email@mg.example.com'
  -F forward.recipient=destination1@gmail.com
  -F forward.recipient=destination2@gmail.com

The match parameter can contain a wild card expression

$ curl -X POST https://api.mailgun.net/v3/forwards
  -F match='match*@mg.example.com'
  -F forward.recipient=catchall@gmail.com

Rules only support  or literal characters where  matches any sequence of characters.  So a.*@example.com matches email addresses that start with a. not email addresses that start with a like a regex match would.

Endpoint: POST /v3/forwards
Version: 3.0.0
Security: basicAuth

## Query parameters:

  - `match` (string, required)
    A wildcard expression which matches the recipient address to forward. This is a insensitive match address

  - `forward.url` (string, required)
    A URL to forward when the rule matches the recipient. May be repeated up to 3 times. Must be a valid URL that resolves

  - `forward.recipient` (string, required)
    A email address to forward to when the rule matches the recipient. May be repeated up to 5 times

  - `forward.store` (string, required)
    A URL which will be used to notify you when the email arrives along with a URL you can use to retrieve the message. Must be a valid URL that resolves

## Response 200 fields (application/json):

  - `id` (string, required)

  - `account_id` (string, required)

  - `domain_name` (string, required)

  - `domain_id` (string, required)

  - `match` (string, required)

  - `forward` (object, required)

  - `forward.urls` (array, required)

  - `forward.recipients` (array)

  - `forward.store` (string)

  - `created_at` (string, required)

  - `updated_at` (string, required)

## Response 400 fields (application/json):

  - `message` (string, required)
    Response message

## Response 401 fields (application/json):

  - `message` (string, required)
    Response message

## Response 500 fields (application/json):

  - `message` (string, required)
    Response message