Create invoice

documented

Creates a draft invoice for an order.

POST /v2/invoicesInvoicesno implementation yet0 runs

No implementation yet. Run it to have the agent write one, or open a pull request with your own.

Seed example (keychains curl)

npx -y keychains@latest curl "https://connect.squareup.com/v2/invoices" \
  -X POST \
  -H "Square-Version: 2026-01-22" \
  -H "Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ \
    "idempotency_key": "{{$idempotency_key}}", \
    "invoice": { \
      "location_id": "{{$location_id}}", \
      "order_id": "{{$order_id}}", \
      "scheduled_at": "{{$scheduled_at}}", \
      "primary_recipient": { \
        "customer_id": "{{$customer_id}}" \
      }, \
      "delivery_method": "EMAIL", \
      "payment_requests": [ \
        { \
          "request_type": "BALANCE", \
          "due_date": "{{$due_date}}", \
          "tipping_enabled": true \
        } \
      ], \
      "invoice_number": "{{$invoice_number}}", \
      "title": "{{$title}}", \
      "description": "{{$description}}", \
      "accepted_payment_methods": { \
        "card": true, \
        "square_gift_card": false, \
        "bank_account": false, \
        "buy_now_pay_later": false, \
        "cash_app_pay": false \
      }, \
      "store_payment_method_enabled": false \
    } \
  }'"}