Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
How do I set up custom OAuth credentials for Stripe?
Use your own Stripe Connect OAuth app when you want users to see your platform's name on the consent screen and control the credentials yourself. If you only need to connect your own Stripe account, an API key is simpler; see the next question.
Create the Stripe OAuth app
- In the Stripe Dashboard, go to Settings → Connect.
- Under Integration settings, click + Add Integration and fill in the form:
- Name: something recognizable, for example
Composio-Integration. - Redirect URL:
https://backend.composio.dev/api/v1/auth-apps/add. It must usehttps, have no trailing slash, and exactly match theoauth_redirect_urifield in your Composio auth config. - Website, Privacy Policy, and EULA are optional.
- Name: something recognizable, for example
- Save the integration and copy the Client ID (starts with
ca_). - For the client secret, Stripe Connect OAuth uses your platform account's secret API key. Copy it from Developers → API keys (
sk_live_, orsk_test_in test mode).
Create the auth config in Composio
- In the Composio dashboard, go to Auth Configs, click Create Auth Config, and select Stripe.

2. Set the authentication type to OAuth2 and choose Use your own developer authentication.
3. Paste the Client ID and the secret key as the Client Secret, then click Create Stripe Auth Config.
4. Click Connect Account, approve access in Stripe, and confirm the account shows as Active.
See Custom auth configs for the general flow.
Scopes
Stripe OAuth has two scopes: read_only and read_write. The default auth config requests read_write. Use read_only if your tools only read data.
How do I connect Stripe with an API key?
- In the Stripe Dashboard, go to Developers → API keys.
- Under Standard keys, copy the Secret key. It starts with
sk_live_, orsk_test_in test mode. Don't use the publishablepk_key.
3. In Composio, go to Auth Configs, click Create Auth Config, select Stripe, and choose API Key as the authentication type. Click Create Stripe Auth Config.
4. Click Connect Account, paste the secret key, and confirm the account shows as Active.
Keep the secret key out of client-side code.
Why is my Stripe trigger enabled but not receiving events?
One possible cause is that the Stripe webhook destination was deleted in Stripe while the trigger still appears enabled. In that state, the trigger can look active, but Stripe has no active destination to send matching events to.
Check the Stripe Dashboard for the webhook destination associated with the trigger. If it is missing or disabled, recreate the trigger so the Stripe webhook destination is created again, then verify new Stripe events are delivered.