Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

next
md 58 lines 5.6 KB
Rendered Raw
1 ## How do I set up custom Google OAuth credentials for Google Business Profile?
2
3 Composio doesn't provide a managed OAuth app for Google Business Profile, so you need your own Google OAuth app to connect it.
4
5 Connect with a Google account that owns or manages the Business Profile. Your Google Cloud project also needs Business Profile API access, which Google approves separately. Google lists a verified profile that has been active for at least 60 days and a matching business website among the [application requirements](https://developers.google.com/my-business/content/prereqs).
6
7 ### Create the Google OAuth app
8
9 1. In [Google Cloud Console](https://console.cloud.google.com/), select the project that will own the OAuth client, or create one.
10
11 ![Google Cloud console project picker](/images/toolkits/shared/9j8wjr2HocIhIsgedntpgb4m8Y.webp)
12
13 2. Request Business Profile API access for your Cloud project and wait for Google's approval.
14 3. After approval, open **APIs & Services** → **Library**, search for **My Business Account Management API** (`mybusinessaccountmanagement.googleapis.com`), and select **Enable**. If the page shows **Manage**, the API is already enabled. Composio uses it to list accounts and check the connection. Enable any other Business Profile APIs your actions use. See Google's [basic setup](https://developers.google.com/my-business/content/basic-setup).
15 4. Open **Google Auth Platform** → **Branding**. If Google shows **Get started**, enter the app name, user support email, and developer contact email, then save.
16
17 ![Google Auth Platform Branding page with app name and user support email](/images/toolkits/shared/Q8INvnJoiCMyajqrrAtq6ovCE5U.webp)
18
19 5. Open **Audience**. Choose **Internal** to limit the app to users in your Google Workspace organization, or **External** for consumer accounts and users outside it. While an external app's publishing status is **Testing**, only accounts listed under **Test users** can connect, so add every account you'll test with.
20
21 ![Google Auth Platform Audience page with Testing status, External user type, and Test users](/images/toolkits/shared/BetTxXqa2c1dgg4QeV4g9RV008.webp)
22
23 6. Open **Data Access** → **Add or remove scopes** and add the scopes listed under **Scopes** below. If a scope isn't in the list, paste its full URL under **Manually add scopes** and select **Add to table**. Select **Update**, then **Save**.
24 7. Open **Clients** → **Create client**, choose **Web application**, and give it a name.
25
26 ![Create OAuth client ID form with Web application selected](/images/toolkits/shared/S7mFFv6C5mCP4y0ScTzRzQd8Nc.webp)
27
28 8. Under **Authorized redirect URIs**, add `https://backend.composio.dev/api/v1/auth-apps/add`. It must exactly match the `oauth_redirect_uri` field on your Composio auth config.
29
30 ![OAuth client form with the Composio redirect URI under Authorized redirect URIs](/images/toolkits/shared/1qh7A0aEGRUU1K19aU37FrcxTY.webp)
31
32 9. Select **Create**. Copy the **Client ID** and **Client secret**. Google shows the full secret only once, so save it before you close the dialog.
33
34 ![Google OAuth web client details with Client ID and Client secret](/images/toolkits/shared/TmVTLOgVKQDqamjQVxKDBXJtPQ.webp)
35
36 ### Create the auth config in Composio
37
38 1. In the [Composio dashboard](https://dashboard.composio.dev/~/project/auth-configs?utm_source=docs&utm_medium=content&utm_campaign=toolkits-google_business_profile), open **Auth Configs** → **Create** and select **Google Business Profile**.
39 2. Choose **OAuth 2.0** and **Your Own Credentials**, then paste your **Client ID** and **Client secret**. Leave **Redirect URI** unchanged, keep the scopes in line with what you added in Google, and select **Create Auth Config**.
40 3. Open the auth config, select **Connect Account**, and sign in with the Google account that manages the profile. If the Account Management API is unavailable or shows a quota of zero, the project's Business Profile API access hasn't been approved. OAuth app verification and Business Profile API approval are separate.
41
42 ![Google consent screen asking to manage your Google business listings](/images/toolkits/google_business_profile/google-consent-screen.webp)
43
44 4. Open **Accounts** on the auth config and confirm the connected account shows **Active**. The auth config's own **Enabled** label doesn't confirm a connection.
45
46 For the general flow, see [Custom auth configs](/docs/auth-configuration/custom-auth-configs).
47
48 ### Scopes
49
50 The default auth config requests `https://www.googleapis.com/auth/business.manage`. Account listing requires it, and it can authorize changes to any profile the signed-in user can manage.
51
52 Short scope names on this page leave out the `https://www.googleapis.com/auth/` prefix. When you paste a scope under **Manually add scopes**, use the full URL, for example `https://www.googleapis.com/auth/userinfo.email`. Scopes already written as a full URL, such as `https://mail.google.com/`, go in as shown.
53
54 ### Publish and verify the app
55
56 While an external app is in **Testing**, Google shows an unverified-app notice and refresh tokens expire after seven days, so users have to reconnect. Before you invite production users, select **Publish app** on the **Audience** page. A public app that requests sensitive or restricted scopes also needs Google's OAuth verification, which you start from **Verification Center**. Publishing doesn't complete verification on its own. Internal apps and apps in Testing can be exempt. See Google's [verification requirements](https://developers.google.com/identity/protocols/oauth2/production-readiness/overview).
57
58 If you change the requested scopes later, reconnect the account so the user grants the new access.