JIRA Cloud Platform
With JIRA Cloud Platform modules in Make, you can watch, create, update, retrieve, search, list, assign/unassign, and delete issues, issue comments, issue links, watchers, custom field options, components, project visions, and users and make API calls.
To get started with JIRA Cloud Platform, create a JIRA account at atlassian.com.
Refer to the JIRA Cloud Platform API documentation for the list of available endpoints.
To connect JIRA Cloud Platform to Make, you must first create an API token.
To do so, follow these steps:
Click Create API token.
- Enter a Label for the API token and click Create.
- Click Copy and store your generated token in a safe place as you will not be able to view the token again after closing this dialog.
- Log in to your Make account and add a JIRA Cloud Platform module to a .
- Click Add next to the Connection field.
- Optional: In the Connection name field, enter a name for the connection.
- Fill in the Service URL and Username and paste your API Token from step 4.
- Click Save.
You have successfully established the connection. You can now edit your and add more JIRA Cloud Platform modules. If your connection needs reauthorization at any point, follow the connection renewal steps here.
This app uses webhooks to trigger a scenario when an event occurs instantly. Follow the steps below to set them up.
Your JIRA account must have Administer Jira: Global permissions to create webhooks.
- Go to your Make account and open the JIRA Cloud Platform Watch Issues Instant Acid module in a .
- Click Add next to the Webhook field.
- Optional: In the Webhook name field, enter a name for the webhook.
- Select the Hook type and click Save.
- Copy the generated URL address and click OK.
- Go to Jira and click the Settings Icon > System. In the Advanced section, click WebHooks.
- Here you can create a webhook using the copied URL from step 5. Please refer to the Jira Cloud platform Webhooks documentation as a guide.
From July 1, 2023, there will be a limit of up to 100 active Jira admin webhooks per Jira instance.
After connecting the app, you can perform the following actions:
- Watch IssuesTriggers when a ticket event occurs.
- Watch IssuesTriggers when an issue is created or updated.
- Create an IssueCreates a new issue.
- Update an IssueUpdates an existing issue.
- Get an IssueReturns the details for an issue.
- Search IssuesSearches for issues.
- List Current Available Transitions in an IssueLists current available transitions in an issue.
- Update an Issue Status (Transition Issue)Updates an issue status.
- Assign/Unassign an IssueAssigns an issue to a user.
- Get Changelog of an IssueRetrieves changelog of an issue.
- Delete an IssueDeletes an issue.
- Add an Issue CommentAdds a comment to an issue.
- Update an Issue CommentUpdates a comment to a specific issue.
- Get an Issue CommentReturns an issue comment.
- List Issue CommentsReturns all comments for an issue.
- Delete an Issue CommentDeletes a comment on a specific issue.
- Create an Issue LinkCreates an issue link.
- Delete an Issue LinkDeletes an issue link.
- Add a WatcherAdds a user as a watcher on an issue.
- List Issue WatchersReturns the watchers for an issue.
- Delete a Watcher from an IssueDeletes a user as a watcher of an issue.
- Add an AttachmentAdds a new attachment to a ticket.
- Download an AttachmentDownloads an attachment.
- Delete an AttachmentDeletes an attachment.
- Create Custom Fields OptionsCreates options for a custom select field.
- Update Custom Fields OptionsUpdates the options of a custom field.
- Get All Custom Field OptionsReturns a list of all the options of a select list issue field.
- Reorder Custom Fields OptionsChanges the order of custom field options or cascading options in a context.
- Delete Custom Field OptionDeletes a custom field option.
- Create a ComponentCreates a component.
- Update a ComponentUpdates a component.
- List Project ComponentsRetrieves project components.
- Delete a ComponentDeletes a component.
- Create a Project VersionCreates a project version.
- Update a Project VersionUpdates a project version.
- List Project VersionsRetrieves all versions in a project.
- Delete a Project VersionDeletes a project version.
- List UsersRetrieves all users (active and inactive).
- Search UsersSearches for users by query.
- Get a UserReturns a user.
- Make an API CallPerforms an arbitrary authorized API call.
When retrieving issues from JIRA via webhooks or Get Actions, basic sample data from the general JIRA installation is available. In order to get your custom fields, there must be at least one issue available in JIRA for Make to retrieve it and remember the custom fields. Once you run your (or run a single JIRA module) the fields become available. These custom fields are available only on your computer as they are saved in your browser. If you access Make from another computer, you must repeat the process.