FUfundraiseup
Designations

Update multiple designations

Changed on

Use this request to update up to 100 designations in your account in a single call. Only the provided fields are updated; omitted fields keep their current values. Each item is processed individually, and the response contains a per-item result with either the updated designation or an error.

post/v1/designations/batch/update

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": [
    {
      "id": "EXXXXXXX",
      "code": "Code-1",
      "name": "My Designation"
    }
  ],
  "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"
      },
      "error": {
        "code": "designation_not_found",
        "message": "Designation not found."
      },
      "id": "EXXXXXXX"
    }
  ],
  "status": "complete"
}

Changes