# Create a gift order

Send gift(s) by creating an order request.

Endpoint: POST /api/v1/orders
Version: 1.0
Security: ApiTokenAuth

## Header parameters:

  - `X-Customer-Request-Id` (string)
    Customer supplied request Id (optional)
    Example: "Gf3rf11-181e-443f9-aba5-aeasf32203e1"

  - `X-Workspace-id` (string, required)
    Workspace ID for authentication
    Example: "444"

## Request fields (application/json):

  - `orderItems` (array, required)
    Gift(s) being ordered. Minimum of 1 Gift. Max of 20 Gifts.

  - `orderItems.message` (string, required)
    Message to the recipient
    Example: "Good job! Here's a little something on me"

  - `orderItems.amount` (number, required)
    Amount of the gift. Limited to 10,000
    Example: 25

  - `orderItems.recipient` (object, required)
    Recipient request object where either employeeNumber or email must be provided. In case both are present, email will take precedence.

  - `orderItems.recipient.firstName` (string)
    Recipient's first name
    Example: "John"

  - `orderItems.recipient.lastName` (string)
    Recipient's last name
    Example: "Doe"

  - `orderItems.recipient.employeeNumber` (string)
    employee #
    Example: "5462"

  - `orderItems.recipient.email` (string)
    Recipient's email address
    Example: "john.doe@example.com"

  - `currency` (string, required)
    Currency of gift
    Enum: "CAD", "USD"

  - `language` (string)
    Preferred language for the message
    Enum: "ES_MX", "FR_CA", "EN_CA"

## Response 201 fields (application/json):

  - `requestId` (string)
    Order request Id, used for tracking your order request
    Example: "c3c0029f-181e-41f9-aba5-ae99602203e1"

  - `requestStatus` (string)
    Status of a request
    Enum: "ACCEPTED", "WAITING_PROCESSING", "PROCESSING_IN_PROGRESS", "COMPLETED", "FAILED"

  - `orderStep` (string)
    Progression step of an order
    Enum: "PENDING", "PRECHECK_ORDER", "NORMALIZE_ACCOUNT", "NORMALIZE_PAYMENT", "CERTIFICATE_VALIDATION", "COST_CENTER_VALIDATION", "BUDGET_VALIDATION", "BALANCE_VALIDATION", "CREATE_ORDER", "FUND_ACCOUNT_REQUEST", "CHARGE_CREDIT_CARD", "TRANSACTION_BUDGET", "TRANSACTION_BALANCE", "PROCESS_PAYMENT", "CERTIFICATE_GENERATED", "GENERATE_GIFT", "PURCHASE_NOTIFIY", "FINISHING", "COMPLETED", "FAIL", "ABORT"

  - `orderId` (integer)
    Created order Id
    Example: 444350

  - `customerRequestId` (string)
    Customer specified request Id
    Example: "Gf3rf11-181e-443f9-aba5-aeasf32203e1"

## Response 400 fields (application/json):

  - `status` (integer)
    HTTP status code
    Example: 404

  - `message` (string)
    Description of error
    Example: "Does not exists"

  - `type` (string)
    Exception types. Please see possible error code on "Responses Codes & Errors" page