---
title: "Create Custom Attribute"
method: POST
path: "/custom/attributes"
tags: ["Custom Attributes"]
---

# Create Custom Attribute

`POST /custom/attributes`

## Request

- Base URL: `https://api.rebrandly.com/v1`
- URL: `https://api.rebrandly.com/v1/custom/attributes`
- Auth: API key in header `apikey`

## Headers

- `Workspace` string
- `apikey` string, required

## Request body

- CustomAttributeInput: Input for creating a custom attribute
  - `key` string, required: Attribute key name
  - `type` 'string' | 'numeric', required: Attribute value type

## Response `200`

Custom attribute created

- CustomAttribute: Custom attribute definition for links
  - `id` string, required: Custom attribute public ID
  - `key` string, required: Attribute key name
  - `type` 'string' | 'numeric', required: Attribute value type

---

[API](https://skmtc.dev/rebrandly/apis/rebrandly-api.md) - [All operations](https://skmtc.dev/rebrandly/apis/rebrandly-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rebrandly/apis/rebrandly-api/revisions/b098bf9fb684?raw)