---
title: "Create Target"
method: POST
path: "/api/v2/targets"
tags: ["Targets"]
---

# Create Target

`POST /api/v2/targets`

#### Allowed For

* Admins

## Response `201`

Created response

- TargetResponse
  - `target` union
    - object
      - `active` boolean — Whether or not the target is activated
      - `created_at` string, date-time — The time the target was created
      - `id` integer — Automatically assigned when created
      - `title` string, required — A name for the target
      - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
      - `message_id` string — Can be filled if it is a "message" resource
      - `password` string — The 37Signals password for the Basecamp account (only writable)
      - `project_id` string, required — The ID of the project in Basecamp where updates should be pushed
      - `resource` string, required — "todo" or "message"
      - `target_url` string, required — The URL of your Basecamp account, including protocol and path
      - `todo_list_id` string — Can be filled if it is a "todo" resource
      - `token` string, required — Get the API token from My info > Show your tokens > Token for feed readers or the Basecamp API in your Basecamp account
      - `username` string — The 37Signals username of the account you use to log in to Basecamp
    - object
      - `active` boolean — Whether or not the target is activated
      - `created_at` string, date-time — The time the target was created
      - `id` integer — Automatically assigned when created
      - `title` string, required — A name for the target
      - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
      - `preserve_format` boolean
      - `room` string, required
      - `ssl` boolean
      - `subdomain` string, required
      - `token` string, required
    - object
      - `active` boolean — Whether or not the target is activated
      - `created_at` string, date-time — The time the target was created
      - `id` integer — Automatically assigned when created
      - `title` string, required — A name for the target
      - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
      - `api_id` string, required
      - `attribute` string — Read-only
      - `from` string
      - `method` string — Read-only
      - `password` string, required — only writable
      - `target_url` string — Read-only
      - `to` string, required
      - `us_small_business_account` string
      - `username` string, required
    - object
      - `active` boolean — Whether or not the target is activated
      - `created_at` string, date-time — The time the target was created
      - `id` integer — Automatically assigned when created
      - `title` string, required — A name for the target
      - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
      - `email` string, required
      - `subject` string, required
    - object
      - `active` boolean — Whether or not the target is activated
      - `created_at` string, date-time — The time the target was created
      - `id` integer — Automatically assigned when created
      - `title` string, required — A name for the target
      - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
      - `api_token` string, required
    - object
      - `active` boolean — Whether or not the target is activated
      - `created_at` string, date-time — The time the target was created
      - `id` integer — Automatically assigned when created
      - `title` string, required — A name for the target
      - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
      - `account_name` string, required
      - `email` string, required
      - `password` string, required — only writable
      - `target_url` string
    - object
      - `active` boolean — Whether or not the target is activated
      - `created_at` string, date-time — The time the target was created
      - `id` integer — Automatically assigned when created
      - `title` string, required — A name for the target
      - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
      - `password` string, required — only writable
      - `target_url` string, required
      - `username` string, required
    - object
      - `active` boolean — Whether or not the target is activated
      - `created_at` string, date-time — The time the target was created
      - `id` integer — Automatically assigned when created
      - `title` string, required — A name for the target
      - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
      - `owner_by` string
      - `project_id` string, required
      - `requested_by` string
      - `story_labels` string
      - `story_title` string, required
      - `story_type` string, required
      - `token` string, required
    - object
      - `active` boolean — Whether or not the target is activated
      - `created_at` string, date-time — The time the target was created
      - `id` integer — Automatically assigned when created
      - `title` string, required — A name for the target
      - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
      - `secret` string — only writable
      - `token` string
    - object
      - `active` boolean — Whether or not the target is activated
      - `created_at` string, date-time — The time the target was created
      - `id` integer — Automatically assigned when created
      - `title` string, required — A name for the target
      - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
      - `attribute` string, required
      - `method` string — "get"
      - `password` string — only writable
      - `target_url` string, required
      - `username` string
    - object
      - `active` boolean — Whether or not the target is activated
      - `created_at` string, date-time — The time the target was created
      - `id` integer — Automatically assigned when created
      - `title` string, required — A name for the target
      - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
      - `content_type` string, required — "application/json", "application/xml", or "application/x-www-form-urlencoded"
      - `method` string, required — "get", "patch", "put", "post", or "delete"
      - `password` string — only writable
      - `target_url` string, required
      - `username` string
    - object
      - `active` boolean — Whether or not the target is activated
      - `created_at` string, date-time — The time the target was created
      - `id` integer — Automatically assigned when created
      - `title` string, required — A name for the target
      - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
      - `group_id` string
      - `token` string

## Changes

> 29 revisions in range; 1 not diffed, 1 could not be searched.

- **2025-06-12** `9eac011b0efd` — 1 breaking, 1 info
  - added `#/components/schemas/TargetBasecamp, #/components/schemas/TargetCampfire, #/components/schemas/TargetClickatell, #/components/schemas/TargetEmail, #/components/schemas/TargetFlowdock, #/components/schemas/TargetGetSatisfaction, #/components/schemas/TargetJira, #/components/schemas/TargetPivotal, #/components/schemas/TargetTwitter, #/components/schemas/TargetURL, #/components/schemas/TargetHTTP, #/components/schemas/TargetYammer` to the `target/allOf[subschema #2]/` response property `oneOf` list for the response status `201`
  - removed `#/components/schemas/TargetBasecamp, #/components/schemas/TargetCampfire, #/components/schemas/TargetClickatell, #/components/schemas/TargetEmail, #/components/schemas/TargetFlowdock, #/components/schemas/TargetGetSatisfaction, #/components/schemas/TargetJira, #/components/schemas/TargetPivotal, #/components/schemas/TargetTwitter, #/components/schemas/TargetURL, #/components/schemas/TargetHTTP, #/components/schemas/TargetYammer` from the `target/allOf[subschema #2]/` response property `anyOf` list for the response status `201`

[Change history](https://skmtc.dev/botbrains-io/apis/support-api/changes/api/v2/targets/post.md)

---

[API](https://skmtc.dev/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.dev/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botbrains-io/support-api/revisions/d53eac07ba68/schema)