Documentation / Account
Account
Manage your profile, plan, emails, tokens, team, and usage, and see which tasks your AI agent can handle.
The profile menu
Click the profile icon at the top right of the web app. On oppalerts.com, the same icon appears when you are signed in. The menu shows your name and email address, followed by these items:
- Profile: Profile.
- Account & billing: Subscription.
- API & MCP Tokens: API & MCP Tokens.
- Team: Team. In the web app, this item appears only for the account owner and account editors.
- Usage: Usage.
- Sign out.
If you belong to another account's team, the web app's profile menu also lists each account you can access. Click an account to switch to it. The URL does not change.
Email notifications, Downloads, and
Password are not in the profile menu. They are in the list
of links at the bottom of the Profile page and of every other page under
/account.
The account pages
- Profile,
https://oppalerts.com/account: your name, your plan, and Log out. - Subscription,
https://oppalerts.com/account/subscription: your plan, the billing date, upgrades, downgrades, invoices, payment method, and cancellation. - Email Notifications,
https://oppalerts.com/account/newsletter: the newsletter and the onboarding emails. - Downloads,
https://oppalerts.com/account/downloads: files you requested by email. - API & MCP Tokens,
https://oppalerts.com/app/account/api_tokens: tokens for the MCP server and the API, connected apps, and the "Set up my agent" prompt. - Team,
https://oppalerts.com/app/account/team: people who can access your account and what each person can do. - Usage,
https://oppalerts.com/app/account/usage: account usage by token and day. - Password,
https://oppalerts.com/account/password: change the password that you sign in with.
Pages under /account are on the website. Pages under
/app/account are in the web app. To open them, you need a plan,
a free account, or access to an account through a team.
What MCP and the API can do
An AI agent, for example Claude Code or Codex, can handle almost all of your campaign work through the MCP server. Your own code can do the same through the API.
Read
- All searches and tools that read campaign data.
account_calls_left: how many calls your account has left today.account_usage: account usage for the last 14 days, matching the Usage page.account_team_members: the account's team list, with read-only access.
Change a campaign
These tools are new in this release. Each requires the scope
api:write.
campaigns_create: create a campaign.campaigns_update: change the label. Before finalizing, you can also change the industry and description.campaigns_finalize: finalize a campaign to start it.campaigns_archiveandcampaigns_activate: archive a campaign, or make it active again.campaigns_organization_add,campaigns_organization_update, andcampaigns_organization_delete: your brand, the competitors, the partners, and the publishers, with their sites and brand names.campaigns_saved_opportunity_add,campaigns_saved_opportunity_update,campaigns_saved_opportunity_archive, andcampaigns_saved_opportunity_activate: the saved opportunities.campaigns_set_taxonomy_presets: the taxonomy presets of the Content Optimizer.campaigns_set_daily_opportunities_email: the campaign's daily opportunities email.campaigns_rebuild_counts: recalculate the campaign's daily counts.campaigns_rerun_research: restart campaign research after it has stopped.
Finalize
A campaign does not start until it is finalized, and an agent finalizes only with your explicit permission. Campaigns gives the rules.
Who can change what
campaigns_create,campaigns_archive, andcampaigns_activate: the account owner or an account editor.- Every other change tool: the account owner, an account editor, or a campaign editor of that campaign.
- An account viewer and a campaign viewer cannot change anything.
- The rules are the same in the web app, in MCP, and in the API. See Team.
Tokens and apps from before this release
Tokens and connected apps created before this release have no edit permissions. Create a new token or reconnect the app. Authentication gives the steps.
What stays on the website
Complete these tasks yourself on the website. They have no MCP tool or API route:
- Create and revoke tokens: API & MCP Tokens.
- Invite team members, change their permissions, and remove them: Team.
- Change the password: Password.
- Manage billing: Subscription.
- Manage account email notifications, such as the newsletter: Email Notifications.
Why tokens and team permissions are on the website only: this is a security precaution. AI agents read pages from the open web, which can contain instructions for the agent. Those instructions must not be able to make the agent grant someone access to your account. Permissions must be granted by a person on the website; no MCP tool or API route can grant them.
A campaign's daily opportunities email is separate from account emails. An
agent can configure it with campaigns_set_daily_opportunities_email.