> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Issue

Create a new issue in a specified project.

**Requirements for using this action:**

* `TDProjects` application access.
* `Issue: Add Issues` permission.

<Note>
  External Documentation

  To learn more, visit the [TeamDynamix documentation](https://solutions.teamdynamix.com/TDWebApi/Home/section/Issues#POSTapi/projects/issues?NotifyOnClosed=\{NotifyOnClosed}).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter           | Description                                                                                |
  | ------------------- | ------------------------------------------------------------------------------------------ |
  | Category ID         | The ID of the issue category. Can be obtained by using the `List Issue Categories` action. |
  | Description         | A description of the issue.                                                                |
  | End Date            | The completion date for the issue.                                                         |
  | Estimated Hours     | The estimated number of hours required to complete the issue.                              |
  | Notify On Closed    | Select to send notifications to relevant users when the issue is closed.                   |
  | Priority ID         | The ID of the priority level for the issue.                                                |
  | Project ID          | The ID of the project to associate the issue to.                                           |
  | Responsible User ID | The ID of the user responsible for the issue.                                              |
  | Start Date          | The start date for work on the issue.                                                      |
  | Status ID           | The ID of the issue status. Can be obtained by using the `List Issue Statuses` action.     |
  | Title               | The title of the issue.                                                                    |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter         | Description                                                                                                                                                                                                                                                                                        |
  | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Custom Attributes | An array of JSON objects containing custom attribute values for the issue.<br /><br />For more information about the custom attributes parameter, refer to [TeamDynamix API documentation](https://solutions.teamdynamix.com/TDWebApi/Home/type/TeamDynamix.Api.CustomAttributes.CustomAttribute). |
  | Task ID           | The ID of a task to associate with the issue.                                                                                                                                                                                                                                                      |
</div>

## Example Output

```json theme={"dark"}
{
	"EstimatedHours": 0.0,
	"ActualHours": 0.0,
	"StartDate": "",
	"EndDate": "",
	"PriorityID": 0,
	"PriorityName": null,
	"PriorityOrder": 0.0,
	"TaskID": 0,
	"TaskName": null,
	"ID": 0,
	"Title": "",
	"Description": null,
	"IsRead": false,
	"CategoryID": 0,
	"CategoryName": null,
	"StatusID": 0,
	"StatusName": null,
	"StatusValue": 0,
	"DaysOld": 0,
	"ProjectID": 0,
	"ProjectName": null,
	"CreatedDate": "",
	"CreatedFullName": "",
	"CreatedUID": null,
	"CreatedEmail": null,
	"ResponsibleFullName": null,
	"ResponsibleUID": null,
	"ResponsibleEmail": null,
	"ResponsibleIsRead": false,
	"ResponsibleDateRead": "",
	"ModifiedDate": "",
	"ModifiedFullName": "",
	"ModifiedUID": null,
	"Flagged": false,
	"DateFlagged": "",
	"LastUpdateText": null,
	"LastUpdatedDate": "",
	"LastUpdatedByFullName": "",
	"LastUpdatedByUID": null,
	"Attributes": null,
	"CompletedDate": "",
	"CompletedUID": null,
	"CompletedFullName": null
}
```

## Workflow Library Example

[Create Issue with Teamdynamix and Send Results Via Email](https://library.blinkops.com/workflows/create-issue-with-teamdynamix-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/create-issue-with-teamdynamix-and-send-results-via-email/canvas" />
</div>
