Skip to main content
This is the GraphQL API path to an integration. For other approaches, such as the Workflow Builder, see Create an integration. Once your first calls work (see Getting started), follow this path to take an integration to production.

​
Get access

For your own org, ask an admin for access to your sandbox. For an external org, that org grants you access to their environment.
Gov Cloud is restricted to US persons only. If you’re a non-US person building for a Gov Cloud organization, use your own ION sandbox and grant access to other domains instead.
If your organization doesn’t have a sandbox yet, reach out to First Resonance to request one.

​
Set permissions

An admin grants the permissions your integration needs. An API key holds the permissions its creating user had at the moment it was generated. Set those permissions first. See the permissions reference, Manage API keys, and Webhooks.

​
Connect

Obtain an access token (Authentication) and subscribe to the events you care about (Webhooks). You can build the integration in a traditional environment such as Python or Node.js, or in a low-code iPaaS tool.

​
Map the flow

List the triggers, steps, and API calls your integration needs. Configure any new custom attributes to represent data that doesn’t have a home in ION yet.
Every unique mutation in ION has an associated permission. Use the API playground to confirm which permissions a call requires before you build.

​
Test and promote

Validate your edge cases against the sandbox, then roll out to production. The production environment needs its own set of API keys and webhook receivers.