FUfundraiseup
Designations

Create multiple designations

Changed on

Use this request to create up to 100 designations in your account in a single call. Each item is processed individually, and the response contains a per-item result with either the created designation or an error.

post/v1/designations/batch/create

Request

  • Base URL
    https://api.fundraiseup.com (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Request body

livemodeboolean

Specifies whether the request is executed in live or test mode. Required for API keys created after 30th January 2026. Designations only exist in live mode — set this to true.

Example request

{
  "items": [
    {
      "name": "My Designation",
      "code": "Code-1"
    }
  ],
  "livemode": true
}

Response

On success, the API returns the overall status of the bulk operation and an array with the result for each item in the request, in the same order.

status'complete' | 'partial' | 'failed' required

Status of the bulk operation.

Example response

{
  "results": [
    {
      "designation": {
        "account": {
          "code": "Code-1",
          "id": "AXXXXXXX",
          "name": "Example Account"
        },
        "code": "Code-1",
        "created_at": "2024-01-01T00:00:00.000Z",
        "id": "EXXXXXXX",
        "is_default": true,
        "name": "My Designation",
        "updated_at": "2024-01-31T00:00:00.000Z"
      }
    }
  ],
  "status": "complete"
}

Changes