# Create a group order invitation

A group order invitation allows other users to contribute to an existing order. Contributors may request an access token with the invitation ID that allows them to add line items and modify those line items.

Endpoint: POST /me/orderinvitations
Version: 1.0.457.36910
Security: OAuth2

## Security:

  - `OAuth2` (unknown)
    oauth2 scopes: FullAccess, Shopper

## Request fields (application/json):

  - `ExpirationDate` (string)
    Maximum 1 year.

  - `Name` (string)

  - `OrderID` (string)

  - `OrderStatus` (string)
    Enum: "Unsubmitted", "AwaitingApproval", "Declined", "Open", "Completed", "Canceled"

  - `xp` (object)

## Response 201:

  - `201` (unknown)
    A group order invitation allows other users to contribute to an existing order. Contributors may request an access token with the invitation ID that allows them to add line items and modify those line items.

## Response 201 fields (application/json):

  - `ID` (string)

  - `ExpirationDate` (string)
    Maximum 1 year.

  - `Name` (string)

  - `OrderID` (string)

  - `OrderStatus` (string)
    Enum: "Unsubmitted", "AwaitingApproval", "Declined", "Open", "Completed", "Canceled"

  - `xp` (object)

## Response 4XX:

  - `4XX` (unknown)
    Expected errors range from 400-409. Anything in the 5XX range indicates a server issue and should be reported to support.

## Response 4XX fields (application/json):

  - `StatusCode` (integer)
    Example: 404

  - `ErrorCode` (string)
    Example: NotFoundError

  - `Message` (string)
    Example: Object not found

  - `Data` (object)
    Example: {"ObjectType":"","ObjectID":""}