> ## 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.

# Link Issues

Creates a link between two issues. Use this operation to indicate a relationship between two issues and optionally add a comment to the from (outward) issue. To use this resource the site must have [Issue Linking](https://confluence.atlassian.com/x/yoXKM) enabled.   This resource returns nothing on the creation of an issue link. To obtain the ID of the issue link, use `https://your-domain.atlassian.net/rest/api/3/issue/[linked issue key]?fields=issuelinks`.   If the link request duplicates a link, the response indicates that the issue link was created. If the request included a comment, the comment is added.   This operation can be accessed anonymously.   **Permissions required:**   \*  *Browse project* [project permission](https://confluence.atlassian.com/x/yodKLg) for all the projects containing the issues to be linked,  \*  *Link issues* [project permission](https://confluence.atlassian.com/x/yodKLg) on the project containing the from (outward) issue,  \*  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue.  \*  If the comment has visibility restrictions, belongs to the group or has the role visibility is restricted to.

<Note>
  External Documentation

  To learn more, visit the [Jira documentation](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-links/#api-rest-api-3-issuelink-post).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter         | Description                                                                                        |
  | ----------------- | -------------------------------------------------------------------------------------------------- |
  | Inward Issue Key  | The ID of the first issue to link. Can be retrieved form the 'List Issues' action.                 |
  | Outward Issue Key | The ID of the second issue to link. Can be retrieved form the 'List Issues' action.                |
  | Type Name         | Defines and reports on issue link types. Can be retrieved from the 'List Issue Link Types' action. |
</div>

## Workflow Library Example

[Link Issues with Jira and Send Results Via Email](https://library.blinkops.com/workflows/link-issues-with-jira-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/link-issues-with-jira-and-send-results-via-email/canvas" />
</div>