Button

Button (usebutton.com) is a mobile commerce technology company whose platform connects Publishers and Brands in a two-sided marketplace: publishers deep-link their users into retailer apps and sites with full attribution, and brands acquire and re-engage customers through those optimized journeys. Its server-to-server APIs cover personalized Offers, attributed Link and Shortlink generation (including Amazon creator links), Brand partnership details, Billing/affiliation transaction reporting, and Order reporting, complemented by Publisher SDKs, Merchant Libraries, and HMAC-signed transaction webhooks.

Button publishes 6 APIs on the APIs.io network, including Accounts API, Brands Api API, Create API, and 3 more. Tagged areas include Commerce, Mobile Commerce, Affiliate, Attribution, and Deep Linking.

The Button catalog on APIs.io includes 1 event-driven AsyncAPI specification.

Button’s developer surface includes documentation, API reference, getting-started guide, support, engineering blog, changelog, authentication, and 28 more developer resources.

🌐 Visit website 📡 Source on GitHub
60.5/100 strong ▬ flat Agent 61/100 agent native Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessSelf serve
7 APIs 1 MCP Servers
CommerceMobile CommerceAffiliateAttributionDeep LinkingOffersPublishersRetail

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 60.5/100 · strong
Contract Quality 17.3 / 25
Developer Ergonomics 16.1 / 20
Commercial Clarity 10.0 / 20
Operational Transparency 7.2 / 13
Governance 0.0 / 12
Discoverability 10.0 / 10
Agent readiness — 61/100 · agent native
Machine-Readable Contract 18 / 18
Agentic Access Contract 0 / 15
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 0 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/usebutton: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 7

Individual APIs this provider publishes, each with its own machine-readable definition.

Button Order API

Brands report new orders, order updates (including partial returns), and cancellations to Button server-to-server, passing the Button Attribution Token (btn_ref) captured by the...

Button Accounts API

The Accounts API from Button — 2 operation(s) for accounts.

Button Brands Api API

The Brands Api API from Button — 1 operation(s) for brands api.

Button Create API

The Create API from Button — 2 operation(s) for create.

Button Links Api API

The Links Api API from Button — 1 operation(s) for links api.

Button Offers API

The Offers API from Button — 1 operation(s) for offers.

Button Transactions API

The Transactions API from Button — 1 operation(s) for transactions.

Scroll for all 7

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

usebutton-mcp.yml

MCP SERVER

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Usebutton Webhooks

ASYNCAPI

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Usebutton Authentication

http · 1 scheme

SECURITY

Usebutton Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Usebutton Vulnerability Disclosure

Hackerone · contact published

SECURITY

Usebutton Trust Center

SOC 2, GDPR

SECURITY

Resources

Get Started 4

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 GettingStarted
GettingStarted
 Login
Login
 Sandbox
Sandbox

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 6

MCP servers, agent skills, and machine-readable catalogs

MCPServer
MCPServer
 LLMsTxt
LLMsTxt
 WellKnown
WellKnown
 AgentSkill
AgentSkill
 AgentSkill
AgentSkill
 AgentSkill
AgentSkill

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Lifecycle
Lifecycle
 Conventions
Conventions
 ErrorCatalog
ErrorCatalog
 Webhooks
Webhooks
 Conformance
Conformance
 DataModel
DataModel

Build 3

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization
 Packages
Packages
 SDKs
SDKs

Access & Security 6

Authentication, authorization, and security posture

Authentication
Authentication
 Compliance
Compliance
 Security
Security
 TrustCenter
TrustCenter
 VulnerabilityDisclosure
VulnerabilityDisclosure
 DomainSecurity
DomainSecurity

Operate 4

Status, limits, changes, and where to get help

Support
Support
 StatusPage
StatusPage
 ChangeLog
ChangeLog
 ChangeLog
ChangeLog

Commercial 2

Pricing, plans, and the legal terms of use

TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 2

The organization behind the API

Website
Website
 Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: usebutton
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/usebutton.png
name: Button
description: 'Button (usebutton.com) is a mobile commerce technology company whose platform connects Publishers and Brands
  in a two-sided marketplace: publishers deep-link their users into retailer apps and sites with full attribution, and brands
  acquire and re-engage customers through those optimized journeys. Its server-to-server APIs cover personalized Offers, attributed
  Link and Shortlink generation (including Amazon creator links), Brand partnership details, Billing/affiliation transaction
  reporting, and Order reporting, complemented by Publisher SDKs, Merchant Libraries, and HMAC-signed transaction webhooks.'
url: https://raw.githubusercontent.com/api-evangelist/usebutton/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- norwest-venture-partners
- slow-ventures
x-tier: stub
x-tier-reason: portfolio-lead
x-enrichment:
  date: '2026-07-21'
  status: enriched
  artifacts_added: 30
  pass: local-v1
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-21'
tags:
- Commerce
- Mobile Commerce
- Affiliate
- Attribution
- Deep Linking
- Offers
- Publishers
- Retail
apis:
- name: Button Order API
  description: Brands report new orders, order updates (including partial returns), and cancellations to Button server-to-server,
    passing the Button Attribution Token (btn_ref) captured by the Merchant Library; documented in the guides with create
    (POST /v1/order), update (POST /v1/order/{order_id}), and cancel (DELETE /v1/order/{order_id}).
  humanURL: https://developer.usebutton.com/docs/order-api-overview
  baseURL: https://api.usebutton.com/v1/order
  tags:
  - Orders
  - Brands
  properties:
  - type: Documentation
    url: https://developer.usebutton.com/docs/order-api-overview
- aid: usebutton:usebutton-accounts-api
  name: Button Accounts API
  description: The Accounts API from Button — 2 operation(s) for accounts.
  humanURL: https://developer.usebutton.com/reference/list-brand-details
  baseURL: https://api.usebutton.com/v1/brands
  tags:
  - Accounts
  properties:
  - type: OpenAPI
    url: openapi/usebutton-accounts-api-openapi.yml
  - type: Documentation
    url: https://developer.usebutton.com/reference/list-brand-details
  - type: Documentation
    url: https://developer.usebutton.com/reference/billing-api-introduction
  - type: Documentation
    url: https://developer.usebutton.com/reference/generate-a-link-2
  - type: Documentation
    url: https://developer.usebutton.com/reference/generate-a-brand-shortlink
  - type: Documentation
    url: https://developer.usebutton.com/docs/getting-button-content
- aid: usebutton:usebutton-brands-api-api
  name: Button Brands Api API
  description: The Brands Api API from Button — 1 operation(s) for brands api.
  humanURL: https://developer.usebutton.com/reference/list-brand-details
  baseURL: https://api.usebutton.com/v1/brands
  tags:
  - Brands Api
  properties:
  - type: OpenAPI
    url: openapi/usebutton-brands-api-api-openapi.yml
  - type: Documentation
    url: https://developer.usebutton.com/reference/list-brand-details
  - type: Documentation
    url: https://developer.usebutton.com/reference/billing-api-introduction
  - type: Documentation
    url: https://developer.usebutton.com/reference/generate-a-link-2
  - type: Documentation
    url: https://developer.usebutton.com/reference/generate-a-brand-shortlink
  - type: Documentation
    url: https://developer.usebutton.com/docs/getting-button-content
- aid: usebutton:usebutton-create-api
  name: Button Create API
  description: The Create API from Button — 2 operation(s) for create.
  humanURL: https://developer.usebutton.com/reference/list-brand-details
  baseURL: https://api.usebutton.com/v1/brands
  tags:
  - Create
  properties:
  - type: OpenAPI
    url: openapi/usebutton-create-api-openapi.yml
  - type: Documentation
    url: https://developer.usebutton.com/reference/list-brand-details
  - type: Documentation
    url: https://developer.usebutton.com/reference/billing-api-introduction
  - type: Documentation
    url: https://developer.usebutton.com/reference/generate-a-link-2
  - type: Documentation
    url: https://developer.usebutton.com/reference/generate-a-brand-shortlink
  - type: Documentation
    url: https://developer.usebutton.com/docs/getting-button-content
- aid: usebutton:usebutton-links-api-api
  name: Button Links Api API
  description: The Links Api API from Button — 1 operation(s) for links api.
  humanURL: https://developer.usebutton.com/reference/list-brand-details
  baseURL: https://api.usebutton.com/v1/brands
  tags:
  - Links Api
  properties:
  - type: OpenAPI
    url: openapi/usebutton-links-api-api-openapi.yml
  - type: Documentation
    url: https://developer.usebutton.com/reference/list-brand-details
  - type: Documentation
    url: https://developer.usebutton.com/reference/billing-api-introduction
  - type: Documentation
    url: https://developer.usebutton.com/reference/generate-a-link-2
  - type: Documentation
    url: https://developer.usebutton.com/reference/generate-a-brand-shortlink
  - type: Documentation
    url: https://developer.usebutton.com/docs/getting-button-content
- aid: usebutton:usebutton-offers-api
  name: Button Offers API
  description: The Offers API from Button — 1 operation(s) for offers.
  humanURL: https://developer.usebutton.com/reference/list-brand-details
  baseURL: https://api.usebutton.com/v1/brands
  tags:
  - Offers
  properties:
  - type: OpenAPI
    url: openapi/usebutton-offers-api-openapi.yml
  - type: Documentation
    url: https://developer.usebutton.com/reference/list-brand-details
  - type: Documentation
    url: https://developer.usebutton.com/reference/billing-api-introduction
  - type: Documentation
    url: https://developer.usebutton.com/reference/generate-a-link-2
  - type: Documentation
    url: https://developer.usebutton.com/reference/generate-a-brand-shortlink
  - type: Documentation
    url: https://developer.usebutton.com/docs/getting-button-content
- aid: usebutton:usebutton-transactions-api
  name: Button Transactions API
  description: The Transactions API from Button — 1 operation(s) for transactions.
  humanURL: https://developer.usebutton.com/reference/list-brand-details
  baseURL: https://api.usebutton.com/v1/brands
  tags:
  - Transactions
  properties:
  - type: OpenAPI
    url: openapi/usebutton-transactions-api-openapi.yml
  - type: Documentation
    url: https://developer.usebutton.com/reference/list-brand-details
  - type: Documentation
    url: https://developer.usebutton.com/reference/billing-api-introduction
  - type: Documentation
    url: https://developer.usebutton.com/reference/generate-a-link-2
  - type: Documentation
    url: https://developer.usebutton.com/reference/generate-a-brand-shortlink
  - type: Documentation
    url: https://developer.usebutton.com/docs/getting-button-content
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://usebutton.com
- type: DeveloperPortal
  url: https://developer.usebutton.com
- type: Documentation
  url: https://developer.usebutton.com/docs
- type: APIReference
  url: https://developer.usebutton.com/reference
- type: GettingStarted
  url: https://developer.usebutton.com/reference/getting-started
- type: Support
  url: https://www.usebutton.com/contact-us
- type: Blog
  url: https://www.usebutton.com/blog
- type: GitHubOrganization
  url: https://github.com/button
- type: Login
  url: https://app.usebutton.com/account/login
- type: TermsOfService
  url: https://www.usebutton.com/support/terms-of-service
- type: PrivacyPolicy
  url: https://www.usebutton.com/support/privacy-policy
- type: StatusPage
  url: https://status.usebutton.com
- type: ChangeLog
  url: changelog/usebutton-changelog.yml
- type: ChangeLog
  url: https://developer.usebutton.com/changelog
- type: Lifecycle
  url: lifecycle/usebutton-lifecycle.yml
- type: Authentication
  url: authentication/usebutton-authentication.yml
- type: Conventions
  url: conventions/usebutton-conventions.yml
- type: ErrorCatalog
  url: errors/usebutton-problem-types.yml
- type: Webhooks
  url: asyncapi/usebutton-webhooks.yml
- type: Sandbox
  url: sandbox/usebutton-sandbox.yml
- type: Packages
  url: packages/usebutton-packages.yml
- type: SDKs
  url: packages/usebutton-packages.yml
- type: MCPServer
  url: mcp/usebutton-mcp.yml
- type: LLMsTxt
  url: llms/usebutton-llms.txt
- type: WellKnown
  url: well-known/usebutton-well-known.yml
- type: Conformance
  url: conformance/usebutton-conformance.yml
- type: Compliance
  url: https://www.usebutton.com/support/security
- type: Security
  url: https://www.usebutton.com/support/security
- type: DataModel
  url: data-model/usebutton-data-model.yml
- type: AgentSkill
  name: Fetch offers and generate an attributed link
  url: skills/usebutton-offers-to-link.md
- type: AgentSkill
  name: Reconcile commissions with the Billing API
  url: skills/usebutton-billing-reconciliation.md
- type: AgentSkill
  name: Create attributed creator shortlinks
  url: skills/usebutton-creator-shortlinks.md
- type: TrustCenter
  url: security/usebutton-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/usebutton-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/usebutton-domain-security.yml