Starts the API-brokered OAuth connection of the caller's profile to an ArcGIS account. Send the user to consent_url; ArcGIS redirects back to redirect_uri with code and state, which the consumer posts to POST /integrations/arcgis/connection.
redirect_urimust exactly match an entry of thearcGisRedirectUrisserver config (a JSON array or comma-separated list).portal_urldefaults tohttps://www.arcgis.com/sharing. Anyhttps://*.arcgis.com/sharingportal is accepted. An ArcGIS Enterprise portal must behttps, end in/sharing, and exactly match an entry of thearcGisPortalAllowlistserver config.consent_urlcarries the app's client id only, never a secret, and asks for a non-expiring refresh token.stateis signed and valid for 15 minutes.
Authorization
Internal API clients only, and the user must be a SERVER or COMPANY user.
POST
/integrations/arcgis/connection/initiate
curl \
--request POST 'https://api.iformbuilder.com/exzact/api/v81/[servername]/integrations/arcgis/connection/initiate' \
--header "Content-Type: application/json" \
--header "Authorization: Bearer {access_token}" \
--data '{
"redirect_uri": "https://app.example.com/integrations/arcgis/callback",
"portal_url": "https://www.arcgis.com/sharing"
}'
Request examples
# Headers
Authorization: Bearer {access_token}
# Payload
{
"redirect_uri": "https://app.example.com/integrations/arcgis/callback",
"portal_url": "https://www.arcgis.com/sharing"
}
Response examples (200)
{
"consent_url": "https://www.arcgis.com/sharing/oauth2/authorize?client_id=abc&response_type=code&redirect_uri=https%3A%2F%2Fapp.example.com%2Fintegrations%2Farcgis%2Fcallback&state=eyJ...&expiration=-1",
"state": "string"
}
Response examples (400)
{
"error_message": "string"
}
Response examples (403)
{
"error_message": "string"
}
Response examples (503)
{
"error_message": "string"
}