# Create a task in the tool for a savings recommendation

Source: https://docs.levelfour.ai/api-reference/integrations/post-integrations-by-id-tasks


## POST /api/v1/integrations/{tool}/tasks

### Authentication

Send `Authorization: Bearer <token>`.

### Parameters

- `tool` (path, string, required)

### Request body

Required. Content type `application/json`.

- `recommendation_id` (string, nullable): The savings recommendation this task tracks
- `commitment_id` (string, nullable): The commitment this task tracks
- `title` (string, required): Task title, prefilled from the record and user-editable
- `description` (string, default ``): Task description (may be empty)
- `link` (string, default ``): Dashboard deep link back to the record
- `monthly_savings` (number, default `0`): Savings only. Estimated USD savings per month
- `annual_savings` (number, default `0`): Savings only. Estimated USD savings per year
- `committed_monthly` (number, nullable): Commitment only. What the commitment costs per month
- `currency` (string, nullable): Commitment only. Currency of committed_monthly
- `term_months` (integer, nullable): Commitment only. Length of the term in months
- `ends_at` (date string, nullable): Commitment only. The day the commitment ends
- `site_id` (string, nullable): Atlassian cloud id of the site to create the issue on (required for Jira)
- `destination_id` (string, nullable): Jira project id to file the issue under (required for Jira)

### Responses

#### 201: Successful Response

- `success` (boolean, default `true`)
- `timestamp` (date-time string)
- `data` (object, required)
  - `id` (string, required): Identifier of the created task in the tool (Jira issue key, e.g. PLAT-123)
  - `url` (string, required): Absolute url to the created task
  - `title` (string, required): Echo of the created task title

#### Errors

- `400`: Bad Request
- `401`: Authentication Error
- `403`: Authorization Error
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error

Body of `400`, `401`, `403`, `404`, `409`, `422`, `429`, `500`:

- `success` (`false`, required)
- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `details` (any)
- `timestamp` (date-time string, required)