Make this month's invoices now

The monthly run, without waiting for the day: one invoice per live site with a client and a monthly price, never two for the same month (safe to repeat). In "send" mode they are sent and emailed. Refused while monthly invoices are off.

POST/api/v1/monthly-invoices/run

Authentication

An API key as Authorization: Bearer or x-api-key. It needs the invoices:write scope — write, send, mark paid and void client invoices; run monthly invoices; start and stop card autopay.

invoices:writeChanges the live siteIdempotency-Key requiredMCP tool: run_monthly_invoices

Parameters

Named placeholders go in the path; the rest in a JSON body.

No parameters.

Response

200 with JSON on success (schema on the right). Errors use the standard envelope; a retry with the same Idempotency-Key gets the first answer back (how retries work).

curl

curl -X POST 'https://websites.workflowcorp.com/api/v1/monthly-invoices/run' \
  -H "Authorization: Bearer $WEBSITEBUDDY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'

Example arguments

{}

Response schema

{
  "type": "object",
  "properties": {
    "made": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "sent": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "emailed": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "message": {
      "type": "string"
    }
  },
  "required": [
    "made",
    "sent",
    "emailed",
    "message"
  ],
  "additionalProperties": false
}