---
title: "Create a new URL Orb allow-list entry"
method: POST
path: "/organization/{org-slug-or-id}/url-orb-allow-list"
tags: ["Organization"]
---

# Create a new URL Orb allow-list entry

`POST /organization/{org-slug-or-id}/url-orb-allow-list`

## Request

- Base URL: `https://circleci.com/api/v2`
- URL: `https://circleci.com/api/v2/organization/{org-slug-or-id}/url-orb-allow-list`
- Auth: one of:
  - API key in header `Circle-Token`
  - HTTP bearer
  - HTTP basic
  - API key in query parameter `circle-token`

Create a new URL Orb allow-list entry

## Path parameters

- `org-slug-or-id` string, required

## Request body

- object
  - `name` string, required: Name of the URL orb allow-list entry.
  - `prefix` string, required: URL prefix. URL orb references that start with this prefix will be allowed by this allow-list entry.
  - `auth` 'github-oauth' | 'none' | 'bitbucket-oauth' | 'github-app', required: An authentication method to use for fetching URL orb references that match this allow-list entry's prefix. Allowed values are "bitbucket-oauth", "github-oauth", "github-app", or "none".

## Response `200`

The ID of the new URL Orb allow-list entry

- object
  - `id` string, required: URL orb allow-list entry UUID.
  - `message` string, required: Message describing the outcome of an operation

## Other responses

- `default`: Error response.

---

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