Rebrandly for Developers

Use our API to create, track and share custom short links that incorporate your brand domain name.

Get Started

Creating a new tag

Check for compatibility first

Double check whether your API key or OAuth token is enabled to use the Tags feature.
For every account, you can check for features and limits with a preliminary API call.

Tags can be created via a POST method to http://api.rebrandly.com/v1/tags, which accepts a JSON object describing the Tag .

Tag Parameters

The table below shows the parameters you should specify when creating a Tag:

Link property
Type
Constraints
Description

name

string

required
UTF8
Min 2 chars

Unique name of the tag

color

string

optional
Valid hex

Hexadecimal representation of a color assigned to the tag

Creating a new Tag

$ curl http://api.rebrandly.com/tags \
-X POST \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR_TOKEN_HERE' \
-H 'Content-Type: application/json' -d '
{
  "name": "personal",
  "color": "ddeeff"
}'

HTTP/1.1 200 OK

JSON Response (just created Tag)

{
  "id": "3aehje9d536s46d59ba5bcf49b582ear",
  "name": "personal",
  "color": "#ddeeff"
}

Creating a new tag


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.