Jira Software presents specific technical challenges when building production integrations. Primary issues: custom field proliferation, webhook reliability, and API rate limits.

Custom Field Problem:

Jira instances are heavily customized. Standard fields get extended, custom fields added per project or workflow. No two installations have identical schemas. Querying issues returns field IDs ( customfield_10042 ) with no semantic meaning.

Solution requires two-phase approach: schema discovery via /field endpoint to map field IDs to names/types, then runtime field resolution per issue. Caching field schemas per connection reduces API calls but requires invalidation on schema changes.

Webhook Reliability:

Jira webhooks fire on issue transitions but have known delivery issues. Webhooks can arrive out of order, duplicate, or not at all.…