Skip to main content

What the Freshdesk app does

The Freshdesk app creates or updates a Freshdesk contact for each customer. It also creates a ticket for each dispute that opens. The app sets no ticket type, group, or agent.

Before you start

  • You are an owner or an admin of the Dodo Payments business.
  • You have a Freshdesk account. You have the API key of an agent that can see and edit all contacts and tickets.

Install, connect, and configure

1

Install the app

Open Apps, then Explore. Open Freshdesk (publisher Dodo Payments) and select Install app.
The Installed tab of Apps with Freshdesk in the list and the status Active
2

Connect Freshdesk

Select Connect. In Freshdesk, open your profile, then Profile settings, then View API key. Paste the key in the FreshDesk API Key field. Enter the Freshdesk domain, for example acme for https://acme.freshdesk.com, then select Connect. Freshdesk does not check the domain at connect. Check that the domain is correct.
The Connect Freshdesk dialog with the FreshDesk API Key and FreshDesk Domain fields
3

Make the contact fields (optional)

To use Write the Dodo contact fields, open Admin, then Customer fields in Freshdesk. Make three single-line text contact fields: dodo_customer_id, dodo_subscription_status, and dodo_status_updated_at. The app refuses the write when a field does not exist.
4

Choose the settings

Open the Configure tab, set the options, and select Save.
The Configure tab of the Freshdesk app with the setting switches, the Ticket priority, and the Products filter
5

Pick the filters

Pick the products and currencies, then select Save.
The Freshdesk Configure tab with the Products and Currencies filters

Settings

What is sent and when

Dodo Payments sends data after the Dodo Payments event happens. The app sends the email address and the name of the customer. With Write the Dodo contact fields on, it also sends the customer ID, the subscription status, and the time. A dispute ticket shows the amount, the payment ID, the reason, and the Dodo ID. The app sends no card data and no address. The app updates the name of an existing contact at each payment. A name that you changed in Freshdesk changes back to the name in Dodo Payments. The subject of each dispute ticket has a marker, for example [Dodo ID: dsp_123]. The app uses the marker to find the ticket again. Do not remove the marker from the subject of a ticket. If an agent removes the marker, a retry of the same dispute can create a second ticket.

Test the app

1

Use test mode

Install and connect the app in test mode.
2

Make a test dispute

Open a test dispute for a test payment with a test customer email.
3

Check Freshdesk

Open Tickets in Freshdesk. The ticket for the dispute appears with the priority that you set. Open Contacts to see the test customer.

Troubleshooting

Disconnect and uninstall

Turn off the settings on the Configure tab to stop sending data. Uninstall the app to delete the Freshdesk connection. See Manage and uninstall.
Last modified on November 20, 2026