> For the complete documentation index, see [llms.txt](https://docs.diffy.website/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.diffy.website/features/zapier-integration-jira-trello-basecamp-integrations.md).

# Zapier integration (JIRA, Trello, Basecamp integrations)

You can create tickets in your bug-tracking system (i.e. Jira, Asana, Trello, Basecamp etc.) right from Diffy with Zapier integration.

### Join Zapier app

First step is to join our Zapier app <https://zapier.com/developer/public-invite/186916/ccfd9c9c466b1b210062d95d5ffb0408/>

### Create a Zap

The second step is to create a Zap. With an awesome AI prompt in Zapier, it can be as simple as entering "Diffy creates issue in Jira"

<br>

<figure><img src="https://2808221030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWkSLD59cnd4ChYfmqo3r%2Fuploads%2FVH4Wb6y5DR7TbzaeQb8h%2Fimage.png?alt=media&amp;token=f86d4869-15be-43ef-852f-111f07fb5be5" alt=""><figcaption></figcaption></figure>

To authenticate Zapier with Diffy, you need to provide an API key. You can obtain it [here](https://app.diffy.website/#/keys). Remember, you must be the team's primary owner to access the Keys.

Make sure to select the right project in your Zap. Separate Zaps will be required if you plan to integrate multiple Diffy projects with Zapier.

For the field mappings, we recommend using Diffy's Name in the Summary and Diffy's Description as the Description in the Jira issue.

<figure><img src="https://2808221030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWkSLD59cnd4ChYfmqo3r%2Fuploads%2FzFuHegXG0rVam0LdAPFg%2Fimage.png?alt=media&amp;token=f0bcbde7-6add-4cad-b237-dec46b03a96b" alt=""><figcaption></figcaption></figure>

### Create issues from Diffy

Once you publish your zap, go back to your project and see that you now have the fourth option when marking changes: "It's a BUG & create ticket."&#x20;

<figure><img src="https://2808221030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWkSLD59cnd4ChYfmqo3r%2Fuploads%2FWthaUb3dYbOkrvGbuxgm%2Fimage.png?alt=media&amp;token=da19e3b2-3f1d-4365-8ccc-e7f784c02d8d" alt=""><figcaption></figcaption></figure>

This will show a popup to edit the ticket's title and description and create a Jira issue for you.

<figure><img src="https://2808221030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWkSLD59cnd4ChYfmqo3r%2Fuploads%2FapMeaP8sv1JeSnhgtprB%2Fimage.png?alt=media&amp;token=c8da8da4-a740-470e-8dd2-5b9cd0c34f7f" alt=""><figcaption></figcaption></figure>

Also, once you have reviewed your Diff, you can create a single ticket for the whole set of changes. See the new "Create ticket" link in the header.

<figure><img src="https://2808221030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWkSLD59cnd4ChYfmqo3r%2Fuploads%2FbGNUQunIFnVVZ7p3sasc%2Fimage.png?alt=media&amp;token=5d272303-9016-4193-87a5-babaf1ad89c1" alt=""><figcaption></figcaption></figure>

Here is a newly created issue in Jira

<figure><img src="https://2808221030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWkSLD59cnd4ChYfmqo3r%2Fuploads%2FDnkTItPO6Fuo2crXWj3r%2Fimage.png?alt=media&amp;token=ad92d5c5-2a99-45f2-9b3f-a1b74be0b6a3" alt=""><figcaption></figcaption></figure>

In the same way, you can configure creating issues in any other ticketing system: GitHub, Trello, Asana, Basecamp, and others.