---
search:
  tags:
    - Skills
    - POST
seo:
  description: >-
    Imports a Catalog Skill into your organization. The import… Reference for
    the POST /context/skill-catalog/{catalogSlug}/import endpoint in the
    AdCrunch API.
sidebar:
  label: Import a Catalog Skill
  badge: POST
title: Import a Catalog Skill
type: openapi-operation
---
Imports a Catalog Skill into your organization. The import makes a Skill from the name, the description and the body of the Catalog Skill, and sets `source`. Your organization owns the Skill, and can edit it like any other Skill. Send `{}` to keep the slug of the Catalog Skill. Your organization holds at most one import of each Catalog Skill: a second import answers `409` with `error=already_imported`. If a Skill of your organization holds the slug, the answer is `409` with `error=slug_conflict`: send another `slug`.

`POST /context/skill-catalog/{catalogSlug}/import`

**Request body** (`application/json`, required)

- `slug` (string) — Optional slug for the new Skill, normalized to kebab-case. It defaults to the slug of the Catalog Skill. Send one when a Skill of your organization holds that slug.

Request body example:

```json
{
  "slug": "monday-review"
}
```

**Responses**

- `201` — The Skill as the import made it, at \`revision\` 1, with its \`source\`.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`skill:write\`. \`error\` is \`forbidden\`.
- `404` — No Catalog Skill with that slug. \`error\` is \`not\_found\`.
- `409` — Two different conflicts share this status, and \`error\` tells them apart. \`already\_imported\` means that your organization holds an import of this Catalog Skill: \`slug\` names that Skill. \`slug\_conflict\` means that another Skill holds the slug: send another \`slug\`.
- `422` — The slug contains no letter or digit. \`error\` is \`invalid\_slug\`.

Response example, 201:

```json
{
  "body": "## When to run\n\nEvery Monday, before the week starts.\n\n## Steps\n\n1. Call `list_campaigns` for each advertiser.\n2. Call `query_insights` for the last seven days.\n3. Write down the campaigns that missed their target.",
  "createdAt": 1790000000000,
  "createdBy": "usr_4d8b12",
  "description": "Use it every Monday to review the spend and the results of last week.",
  "id": "skl_7c1f90",
  "name": "Weekly performance review",
  "revision": 1,
  "slug": "weekly-performance-review",
  "source": {
    "slug": "weekly-performance-review",
    "version": "2026-10-09"
  },
  "updatedAt": null
}
```
