# groundmail-dev OAuth API

**Canonical:** https://apis.io/apis/groundmail-dev/groundmail-dev-oauth-api/  
**Provider:** groundmail-dev — https://apis.io/providers/groundmail-dev/  
**Base URL:** https://api.groundmail.dev  
**Documentation:** https://docs.groundmail.dev/api-explorer

groundmail-dev OAuth API is one of 18 APIs that [groundmail-dev](https://apis.io/providers/groundmail-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include OAuth. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

OAuth 2.0 Device Authorization Grant (RFC 8628) for the CLI and agents, the authorization code grant with PKCE for the hosted MCP server, dynamic client registration (RFC 7591), token refresh with rotating refresh tokens, revocation (RFC 7009), and a UserInfo endpoint for the `openid` and `email` scopes. These endpoints send CORS headers and answer OPTIONS preflights. Server metadata: https://app.groundmail.dev/.well-known/oauth-authorization-server

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| POST | `/oauth/register` | Register an OAuth client (RFC 7591) |
| POST | `/oauth/device_authorization` | Start a device sign-in (RFC 8628) |
| POST | `/oauth/token` | Exchange a device code, authorization code or refresh token for tokens |
| POST | `/oauth/revoke` | Revoke a token (RFC 7009) |
| GET | `/oauth/userinfo` | Signed-in user (OpenID Connect UserInfo) |
| POST | `/oauth/userinfo` | Signed-in user (OpenID Connect UserInfo) |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/groundmail-dev/openapi/groundmail-dev-oauth-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/groundmail-dev/json-schema/groundmail-dev-send-email-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/groundmail-dev/json-schema/groundmail-dev-email-list-item-schema.json
- **JSONSchema** — https://artifacts.apis.io/groundmail-dev/json-schema/groundmail-dev-email-webhook-event-payload-schema.json
- **JSONSchema** — https://artifacts.apis.io/groundmail-dev/json-schema/groundmail-dev-domain-schema.json
- **JSONSchema** — https://artifacts.apis.io/groundmail-dev/json-schema/groundmail-dev-create-migration-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/groundmail-dev/json-schema/groundmail-dev-remote-apply-dns-credentials-schema.json

## Other groundmail-dev APIs (12)

- [groundmail-dev Automations API](https://apis.io/apis/groundmail-dev/groundmail-dev-automations-api/)
- [groundmail-dev Deliverability API](https://apis.io/apis/groundmail-dev/groundmail-dev-deliverability-api/)
- [groundmail-dev Dmarc API](https://apis.io/apis/groundmail-dev/groundmail-dev-dmarc-api/)
- [groundmail-dev Domains API](https://apis.io/apis/groundmail-dev/groundmail-dev-domains-api/)
- [groundmail-dev Emails API](https://apis.io/apis/groundmail-dev/groundmail-dev-emails-api/)
- [groundmail-dev Events API](https://apis.io/apis/groundmail-dev/groundmail-dev-events-api/)
- [groundmail-dev Inbound API](https://apis.io/apis/groundmail-dev/groundmail-dev-inbound-api/)
- [groundmail-dev Integrations API](https://apis.io/apis/groundmail-dev/groundmail-dev-integrations-api/)
- [groundmail-dev Migrations API](https://apis.io/apis/groundmail-dev/groundmail-dev-migrations-api/)
- [groundmail-dev Smtp Credentials API](https://apis.io/apis/groundmail-dev/groundmail-dev-smtpcredentials-api/)
- [groundmail-dev Suppressions API](https://apis.io/apis/groundmail-dev/groundmail-dev-suppressions-api/)
- [groundmail-dev Templates API](https://apis.io/apis/groundmail-dev/groundmail-dev-templates-api/)

## Tags

OAuth

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/groundmail-dev/groundmail-dev-oauth-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/groundmail-dev/.