Reference
Bitly
Set up Bitly OAuth for link shortening and click analytics
Overview
Section titled “Overview”Connect your users to Bitly for link shortening, click analytics, and link management.
| Property | Value |
|---|---|
| Provider ID | bitly |
| Category | Business |
| PKCE | Supported |
| Token refresh | Not available |
| Redirect URI | Shown in Developer Portal |
Step 1: Create a Bitly OAuth App
Section titled “Step 1: Create a Bitly OAuth App”Go to Bitly Developer Settings
Log in to Bitly and open Settings → Developer settings → API.
Register a new application
Under Registered OAuth applications, click Register new app. Bitly emails you a registration link — open it to complete the registration.
Configure the application
Fill in the application name, link, and description.
Add the redirect URI
Add the Redirect URI from the Developer Portal to the Redirect URIs field and register the app.
Get credentials
Copy the Client ID and Client Secret shown for the registered application.
Step 2: Add to Alter Vault
Section titled “Step 2: Add to Alter Vault”Open the Developer Portal
Go to portal.alterauth.com and navigate to the application.
Add Bitly provider
Go to OAuth Providers > Add Provider > Bitly.
Enter credentials
- Client ID: Paste your Bitly Client ID
- Client Secret: Paste your Bitly Client Secret
Save
Click Save. The provider is now active.
- Bitly does not use scopes. OAuth tokens have full access to the user’s account.
- Bitly tokens do not expire and cannot be refreshed.
- See the Bitly OAuth documentation for more details.
Policy-cataloged operations
Section titled “Policy-cataloged operations”Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.
| Operation ID | Families | Method | Provider path |
|---|---|---|---|
campaigns/create | send | POST | /v4/campaigns |
custom-bitlinks/create | admin, write | POST | /v4/custom_bitlinks |
user/update | admin, write | PATCH | /v4/user |
webhooks/create | admin, write | POST | /v4/webhooks |
bitlinks/create | write | POST | /v4/bitlinks |
bitlinks/update | write | PATCH | /v4/bitlinks/{bitlink} |
expand | write | POST | /v4/expand |
qr-codes/create | write | POST | /v4/qr-codes |
shorten | write | POST | /v4/shorten |
bitlinks/clicks | read | GET | /v4/bitlinks/{bitlink}/clicks |
bitlinks/clicks-summary | read | GET | /v4/bitlinks/{bitlink}/clicks/summary |
bitlinks/get | read | GET | /v4/bitlinks/{bitlink} |
bsds/list | read | GET | /v4/bsds |
campaigns/list | read | GET | /v4/campaigns |
groups/bitlinks | read | GET | /v4/groups/{group_guid}/bitlinks |
groups/get | read | GET | /v4/groups/{group_guid} |
groups/list | read | GET | /v4/groups |
organizations/get | read | GET | /v4/organizations/{organization_guid} |
organizations/list | read | GET | /v4/organizations |
qr-codes/get | read | GET | /v4/qr-codes/{qrcode_id} |
user/get | read | GET | /v4/user |
webhooks/get | read | GET | /v4/webhooks/{webhook_guid} |