---
title: "Create a new custom instruction"
method: POST
path: "/api/ai-customizations/v1/profiles/{profile_id}/instructions"
tags: ["AI Customization Instructions"]
---

# Create a new custom instruction

`POST /api/ai-customizations/v1/profiles/{profile_id}/instructions`

## Request

- Base URL: `https://agency-partner-hub-web.global-aws-use1-p.app-us1.com`
- URL: `https://agency-partner-hub-web.global-aws-use1-p.app-us1.com/api/ai-customizations/v1/profiles/{profile_id}/instructions`
- Auth: one of:
  - API key in header `api-key`
  - HTTP bearer

## Path parameters

- `profile_id` integer, required

## Request body

- CreateCustomInstructionRequest
  - `custom_instruction` string, required: Custom instruction to be used for AI responses. It is validated to ensure it is safe for AI use.
  - `is_enabled` boolean, nullable

## Response `201`

Custom instruction created successfully

- CreateCustomInstructionResponse
  - `id` integer, required

## Other responses

- `400`: Bad Request
- `401`: Authorization error
- `404`: Not Found
- `422`: Unprocessable Content

---

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