POST /api/v2/internal/organizations/resolve_by_names
Internal API - For Zendesk services only
Batch resolve organization names to their corresponding IDs for a given account. Returns a structured response containing matched organization names with their IDs and a list of unmatched names.
This endpoint is designed for efficient bulk lookups, avoiding N+1 queries when importing or processing multiple organization references.
Features
- Case-insensitive matching (e.g., "ACME" matches "Acme")
- Whitespace normalization (leading/trailing spaces ignored)
- Preserves original input names in response keys
- Maximum 1,000 organization names per request
- Account-scoped results
Allowed For
- Subsystem users:
support_importer
Use Cases
- Bulk user imports with organization associations
- Data migration workflows
- Batch processing of organization references
Performance Considerations
- Requests with > 1,000 names will return 400 error
- Database query timeout will return 422 error
- Optimal performance with 100-500 names per request
Servers
- https://{subdomain}.{domain}.com
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
organization_names[] |
Array | Yes |
Array of organization names to resolve. Maximum 1,000 names. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.