Import from Zendesk

Shayan TaslimUpdated

Use the Zendesk importer to migrate posts, comments, upvotes, and followers from a Zendesk community forum (Zendesk Gather) into UserJot boards.

Note

This importer migrates Zendesk community forums, not Zendesk Support tickets or Help Center knowledge base articles. To migrate Zendesk Help Center articles, use Import an existing help center.

Available to workspace admins and owners on every plan, including Free.

Create a confidential OAuth client in Zendesk

UserJot connects to Zendesk with an OAuth client_credentials grant (no redirect URI is needed).

  1. Open Zendesk Admin Center → Apps and integrations → APIs → OAuth clients.

  2. Create a confidential OAuth client and grant it the hc:read and users:read scopes. These scopes let UserJot read community topics, posts, comments, votes, subscriptions, and member emails without accessing Support tickets.

  3. Copy the Client identifier and Client secret.

UserJot does not store your Zendesk credentials permanently. They are encrypted only while the background import job runs and deleted immediately afterward.

Run the import

  1. In UserJot, open Settings → Data & Import and click Import from Zendesk.

  2. Enter your Zendesk subdomain (the .zendesk.com subdomain, such as acme.zendesk.com; custom host-mapped domains like support.acme.com are not accepted), Client identifier, and Client secret, then click Continue.

  3. On Choose topics, map each Zendesk topic to a UserJot board, or leave a topic set to Don't import. Topics whose names match an existing UserJot board (case-insensitive) are pre-selected automatically. Map at least one topic and click Continue.

  4. Review Ready to import (typical runtime is about 15 minutes) and click Start import.

UserJot runs the import in the background and emails the admin who started it once finished (subject: Your Zendesk import is done). Re-running an import is safe because previously imported posts, comments, votes, and followers are deduplicated by their Zendesk IDs.

What gets imported and what is skipped

Zendesk data

Behavior in UserJot

Posts

Imported as public requests with title, body (HTML converted to plain text, up to 20,000 characters), original creation date, status, and upvote total.

Statuses

none → Pending, planned → Planned, completed → Completed, not_planned and answered → Closed.

Comments

Imported flat on their posts (up to 10,000 characters) with creation date and upvote count. Empty comments with no text or images are skipped.

Images

External HTTPS images are copied and attached. Zendesk-hosted /hc/ images stay as links in the body text because Zendesk blocks server-side downloads.

Votes

Upvotes are imported; downvotes are skipped. Individual voter rows are created for users with an email or external ID (deleted Zendesk voters still count in the post's total).

Followers

Imported as request subscribers with their original follow date when the user has an email or external ID.

Not imported

Support tickets, Help Center articles, content tags, downvotes, unmapped topics, and changelogs.

Troubleshooting

  • "We couldn't find a Zendesk account." Enter your .zendesk.com subdomain rather than a custom domain.

  • "Zendesk didn't accept that identifier and secret." Confirm the OAuth client in Zendesk is set to Confidential, not Public.

  • "This OAuth client can't read the forum." Confirm both hc:read and users:read scopes are enabled on the client.

  • Rate limits. Loading topics is limited to 10 requests per hour, and starting an import is limited to 3 per hour and 5 per day.

Next steps

Did this answer your question?