Bitly

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

Go to Bitly Developer Settings

Navigate to Bitly Settings > API > OAuth Apps and sign in.

Register a new application

Click Register New Application.

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.

Get credentials

Copy the Client ID and Client Secret.

Warning

Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

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.

Notes

• 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

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}