---
title: "Create a new CustomAction"
method: POST
path: "/custom_actions.json"
tags: ["Custom Actions"]
---

# Create a new CustomAction

`POST /custom_actions.json`

Outlines the parameters and data fields used when creating a new CustomAction

## Query parameters

- `fields` string

## Headers

- `X-API-VERSION` string

## Request body

- object
  - `data` object, required
    - `label` string, required — Text label to be displayed on the custom link.
    - `target_url` string, required — Target URL which will be opened in a new tab when the user clicks the custom link.
    - `ui_reference` 'activities/show' | 'documents/show' | 'contacts/show' | 'matters/show' | 'folders/show', required — UI reference location within Clio where the link will be displayed.

## Response `201`

Created

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Too Many Requests

---

[API](https://skmtc.net/clio/apis/clio-api-documentation.md) · [All operations](https://skmtc.net/clio/apis/clio-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clio/clio-api-documentation/revisions/73791ddd1207/schema)