Buddy

Let any business connect Buddy to your app in one click.

Asking customers to paste API keys is risky and loses sign-ups. With Buddy OAuth, a business clicks Connect, approves exactly what your app may do, and you get a token. No secrets shared.

BookWell wants to connectto the Linen & Co. workspace
Add and update subscribers
Send approved messages
Read message results
–Cannot change billing or team members
CancelAllow
{ "access_token": "bdo_…",
"scope": "subscribers messages",
"workspace": "ws_linen" }
Connect clicked
BookWell
Access approved
3 permissions
Token issued
One workspace only
Technology fromMeta
Built on the official WhatsApp Business Platform
Inside OAuth
Allow screenScopesAccess tokensRefresh tokensRevoke any timePer workspaceRedirect URLsApp listing

Nobody should paste an API key into your app.

Copy-pasted keys get shared, leaked and never rotated, and every extra step loses customers. OAuth gives your users a familiar Connect button and gives you a scoped token they can revoke.

Today

Keys copied, pasted and forgotten.

  • Customers hunting for an API key in settings.
  • Full-access keys used where read-only would do.
  • Keys shared in email and chat.
  • No easy way for a customer to cut off one app.
  • Drop-off at the hardest step of onboarding.
With OAuth

One click, exactly the access you need.

  • A Connect with Buddy button in your app.
  • A clear screen showing what your app can do.
  • Tokens scoped to the permissions you asked for.
  • Customers revoke your access themselves, any time.
  • More customers finish connecting.

Redirect, approve, connect.

The standard OAuth 2.0 authorization code flow, so your developers already know it.

1

Send them to Buddy

Your Connect button redirects to Buddy with your app ID and the scopes you need.

https://usebuddy.app/oauth/authorize
?client_id=app_bookwell
&response_type=code
&scope=subscribers:write messages:send
&state=RANDOM_STATE
&code_challenge=SHA256_VERIFIER
&code_challenge_method=S256
&redirect_uri=https://bookwell.app/cb
2

They approve

The business picks a workspace and sees exactly what your app is asking for, then clicks Allow.

Linen & Co. workspace
Add and update subscribers
Send approved messages
Allow
3

You get a token

Exchange the code for an access token and refresh token, and call the API on their behalf.

POST /oauth/token
Content-Type: application/x-www-form-urlencoded
grant_type=authorization_code
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET
&code=RETURNED_CODE
&redirect_uri=YOUR_REGISTERED_REDIRECT
&code_verifier=ORIGINAL_VERIFIER
200 access_token, refresh_token

Everything inside OAuth.

What you need to offer a safe, one-click Buddy connection inside your product.

Scopes that ask for only what your app needs.

Request access to subscribers, messages, campaigns or results separately. Businesses see each permission in plain language before they approve.

"

Your customers stay in control: they can see every connected app and revoke one in a click.

Allow screen

A clear, Buddy-hosted screen with your app's name and the permissions it wants.

Access tokens

Short-lived tokens scoped to one workspace and the permissions approved.

Refresh tokens

Get new access tokens without asking the customer again.

Revoke any time

Businesses see connected apps in Buddy settings and remove access in one click.

Per workspace

Agencies and multi-brand businesses connect each workspace separately.

Redirect URLs

Register the URLs your app uses, so tokens only go where you expect.

Consent still applies

Your app's messages follow the same opt-in rules as everything else in Buddy.

Webhooks per connection

Receive events for each connected workspace at your own endpoint.

App listing

Published apps can appear in the Buddy marketplace for businesses to find.

Why OAuth beats pasted keys.

More customers finish connecting.

A Connect button and an Allow screen is the flow people already know from every app they use. No settings to dig through, no keys to copy.

Connect buttonFamiliar flowFewer drop-offs
BookWell · Integrations
WhatsApp by BuddyConnect
A client and an adviser shaking hands
Requested scopes
campaigns:readRequested
messages:sendNot needed
subscribers:writeNot needed

Least privilege, by default.

Ask for read-only results if that's all you need. Customers trust apps that ask for less, and you carry less risk.

Customers stay in control.

Every connected app is listed in the customer's Buddy settings with what it can do, and they can revoke it in one click. That's what makes them comfortable saying yes.

Connected apps
BookWellRevoke
ShipFastRevoke

Who builds with Buddy OAuth.

Booking platforms

Let each business send WhatsApp reminders from their own Buddy.

Booking

Store tools

Sync orders into each merchant's Buddy workspace.

Commerce apps

CRMs

Show WhatsApp history and send messages from contact records.

CRM vendors

Agency dashboards

Report on every client workspace in one place.

Agencies

AI tools

Let an agent draft campaigns in the customer's workspace.

AI products

Three things people ask about OAuth.

Is this standard OAuth?

Yes. Buddy uses the OAuth 2.0 authorization code flow with refresh tokens, so existing libraries work.

What can my app do once connected?

Only what the business approved. Each scope is shown in plain language on the Allow screen.

Can a customer disconnect my app?

Yes, from their Buddy settings at any time. Your tokens stop working immediately.

Questions about OAuth.

Anything else, ask Sarah.She reads every message and writes back herself.
Ask a question
How do I register an OAuth app?

Create an app in your Buddy developer settings, add your redirect URLs and choose the scopes you'll request. You'll get a client ID and secret.

How long do tokens last?

Access tokens are short-lived. Use the refresh token to get a new one without asking the customer again.

Can one connection cover several workspaces?

Each connection is for one workspace. Businesses with several workspaces connect each one.

Can my app appear in the Buddy marketplace?

Yes. Published OAuth apps can be listed so businesses can find and connect them.

How do I get access?

Join the waitlist and tell us what you're building. We'll set up your workspace with test and live keys and help with your first integration.

Give your customers a Connect button they'll trust.

Join the waitlist and register your OAuth app the day you get access.

A client and an adviser shaking hands
Connect
Clicked
Allowed
3 scopes
Token
Issued
Synced
2,418 subscribers