> For the complete documentation index, see [llms.txt](https://apidocs.zerionsoftware.com/doc/iformbuilder-v80/llms.txt)

# Start ArcGIS Connection

> POST /integrations/arcgis/connection/initiate
> 
> 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_uri` must exactly match an entry of the `arcGisRedirectUris` server config (a JSON array or comma-separated list).
> - `portal_url` defaults to `https://www.arcgis.com/sharing`. Any `https://*.arcgis.com/sharing` portal is accepted. An ArcGIS Enterprise portal must be `https`, end in `/sharing`, and exactly match an entry of the `arcGisPortalAllowlist` server config.
> - `consent_url` carries the app's client id only, never a secret, and asks for a non-expiring refresh token.
> - `state` is signed and valid for 15 minutes.
> 
> ### Authorization
> 
> Internal API clients only, and the user must be a SERVER or COMPANY user.



## Servers
- https://api.iformbuilder.com/exzact/api/v80/[servername]: https://api.iformbuilder.com/exzact/api/v80/[servername]


## Authentication methods
- Oauth2


## Parameters
### Headers

- **Authorization** (string)
  e.g. Bearer {access_token}




### Body: application/json (object)

- **redirect_uri** (string)

- **portal_url** (string)



## Responses
### 200
OK

#### Body: application/json (object)
- **consent_url** (string)

- **state** (string)


### 400
Bad Request - `redirect_uri` missing or not allowlisted, or `portal_url` not https, not ArcGIS Online and not allowlisted.

#### Body: application/json (object)
- **error_message** (string)
  human-readable reason for the failure


### 403
Forbidden - not an internal client, or a BASIC user.

#### Body: application/json (object)
- **error_message** (string)
  human-readable reason for the failure


### 503
Service Unavailable - ArcGIS has no client id on this server.

#### Body: application/json (object)
- **error_message** (string)
  human-readable reason for the failure



[Powered by Bump.sh](https://bump.sh)
