---
title: "Create multiple designations"
method: POST
path: "/v1/designations/batch/create"
tags: ["Designations"]
---

# Create multiple designations

`POST /v1/designations/batch/create`

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.

## Request body

- BatchCreateDesignationsRequest — Contains the request parameters required for creating multiple designations.
  - `items` BatchCreateDesignationItem[], required — An array of designations to create.
    - `name` string, required — Designation name.
    - `code` string, nullable — Designation code.
  - `livemode` boolean — 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`.

## Response `200`

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.

- BatchCreateDesignationsResponse — Provides the per-item results of a batch designation create request.
  - `results` BatchCreateDesignationResultItem[], required — An array containing the result for each item in the request, in the same order.
    - `designation` Designation, required — A designation represents a fund allocation category for donations.
      - `account` AccountResponse, required — Organization account information.
        - `code` string, nullable, required — Custom identifier for the organization, set as the Account code in the Fundraise Up account.
        - `id` string, required — Unique identifier of the organization in the format A[A-Z]{7}.
        - `name` string, required — The name of the organization as set in the Fundraise Up account.
      - `code` string, nullable, required — Designation code.
      - `created_at` string, required — Timestamp in ISO 8601 format, indicating when the designation was created in UTC.
      - `id` string, required — Unique designation identifier.
      - `is_default` boolean, required — Indicates whether this is the default designation for the account.
      - `name` string, nullable, required — Designation name.
      - `updated_at` string, required — Timestamp in ISO 8601 format, indicating when the designation was last updated in UTC.
  - `status` 'complete' | 'partial' | 'failed', required — Status of the bulk operation.

## Other responses

- `403` — Forbidden. The API key does not have permission to create designations.

---

[API](https://skmtc.net/fundraiseup/apis/fundraise-up-api.md) · [All operations](https://skmtc.net/fundraiseup/apis/fundraise-up-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fundraiseup/fundraise-up-api/revisions/f59881dadecd/schema)