Grain

​

What’s supported

​

Supported actions

• Proxy Actions, using the base URL https://api.grain.com/_/public-api.

​

Notes

• Grain requires a Public-Api-Version header on every API request, for example Public-Api-Version: 2026-10-01. Proxy calls must include it themselves. For available versions, see Grain’s versions documentation.
• Grain connections use Grain’s default personal scope, which gives the same access as the Grain user who authorizes the connection.

​

Example integration

# amp.yaml
specVersion: 1.0.0
integrations:
  - name: grainIntegration
    displayName: My Grain Integration
    provider: grain
    proxy:
      enabled: true

​

Before you get started

• Client ID
• Client Secret

​

Requesting a Grain OAuth client

1. Contact Grain to request a Client ID and Client Secret for a server-side application. Grain issues these credentials manually; see Grain’s authentication documentation.
2. Ask Grain to register https://api.withampersand.com/callbacks/v1/oauth as the redirect URI prefix for your client.
3. Note the Client ID and Client Secret that Grain provides. You will need these to connect your app to Ampersand.

​

Add your Grain app info to Ampersand

1. Log in to your Ampersand Dashboard.
2. Select the project where you want to create a Grain integration.
3. Select Provider Apps.
4. Select Grain from the Provider list.
5. Enter the Client ID and Client Secret obtained from Grain.
6. Click Save Changes.

​

Using the connector

• Create a manifest file like the example above.
• Deploy it using the amp CLI.
• Embed the InstallIntegration UI component. The UI component will prompt the customer for OAuth authorization.
• Start making Proxy Calls, and Ampersand will automatically handle the authentication with Grain.