{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Torq Ticketing Provider Custom Fields Configuration Guide","siteUrl":"https://docs.synqly.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Torq supports custom fields on cases. Custom fields in Torq are stored as case timeline events — they are not properties on the ticket body itself. This means they are per-ticket by nature, and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project ID"]}," must always be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-find-custom-field-key-names","__idx":0},"children":["1. Find Custom Field Key Names"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field Path (Provider)"]}," in each mapping must be the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["key name"]}," of the custom field as it appears in Torq's case timeline events (event type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVENT_TYPE_CUSTOM_FIELD_UPDATED"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To find key names, navigate to a case in Torq that has custom fields set and inspect the custom field keys shown in the case detail view. The key name displayed in Torq is the value to use in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field Path (Provider)"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-configure-custom-field-mappings","__idx":1},"children":["2. Configure Custom Field Mappings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When creating or editing your integration, enable the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom Field Mappings"]}," toggle. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add CustomFieldMapping"]}," to add an entry for each field you want to map. Fill in the following for each entry:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project ID"]}," ","Must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]},". Torq custom fields are not project-scoped."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field Path (Provider)"]}," ","The Torq field key name found in Step 1 (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alert_source"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}," ","A unique key used to reference this field in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["custom_fields"]}," object when creating or patching tickets (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alert_source"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add CustomFieldMapping"]}," to add additional mappings."]}]},"headings":[{"value":"1. Find Custom Field Key Names","id":"1-find-custom-field-key-names","depth":2},{"value":"2. Configure Custom Field Mappings","id":"2-configure-custom-field-mappings","depth":2}],"frontmatter":{"slug":"guides/provider-configuration/torq-custom-fields-setup","seo":{"title":"Torq Ticketing Provider Custom Fields Configuration Guide"}},"lastModified":"2026-04-30T13:43:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/provider-configuration/torq-custom-fields-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}