# Create invite

Creates and sends an invite to the given email address. Returns the created invite, including its ID for use in the cancel endpoint.

Endpoint: POST /v1/businesses/{client_id}/invites
Version: v1
Security: BearerAuth

## Path parameters:

  - `client_id` (integer, required)
    The ID of the business.

## Request fields (application/json):

  - `email` (string, required)
    The email address to send the invite to.
    Example: jane.doe@example.com

  - `role_id` (string, required)
    The ID of the role to assign to the invitee. Must belong to the business.
    Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

  - `payment_types` (array, required)
    The payment types the invitee will have access to. Must be a non-empty list.
    Example: ["cards","reimbursements"]

## Response 201 fields (application/json):

  - `id` (integer)
    The ID of the invite.
    Example: 99

  - `email` (string)
    The email address the invite was sent to.
    Example: jane.doe@example.com

  - `role_id` (string)
    The ID of the role assigned to the invitee.
    Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

  - `role` (string)
    The name of the role assigned to the invitee.
    Example: Team Member

  - `payment_types` (array)
    The payment types the invitee will have access to.
    Example: ["cards","reimbursements"]

  - `used` (boolean)
    Whether the invite has been accepted.
    Example: false

  - `created` (string)
    The date and time the invite was created in UTC.
    Example: 2026-05-01T00:00:00Z

  - `updated` (string)
    The date and time the invite was last updated in UTC.
    Example: 2026-05-01T00:00:00Z