Create M2M client
Creates an M2M client and returns HTTP 200 with its clientSecret. The secret is shown only once; store it securely. Scopes must be registered M2M scope IDs, and a bearer caller may grant only scopes its own token holds (403 PERMISSION_DENIED with details.exceedingScopes otherwise). New clients start in restricted authorization-access mode with no Amazon authorizations; authorization policy is managed in the dashboard. The organization’s M2M client plan limit applies (403).
Requires every scope: m2m-clients:write.
Authentication
AuthorizationBearer
JWT returned by POST /api/auth/token-exchange. Amazon, authorization invitations, and developer credentials require API-key-derived tokens.
Request
This endpoint expects an object.
name
scopes
Registered M2M scope IDs, no broader than the caller's own token scopes.
environment
Allowed values:
description
expiry
Access JWT lifetime in seconds. Defaults to 900.
Response
Created. clientSecret is returned only in this response.
m2mClient
M2M client metadata. The client secret is never included.
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error
503
Service Unavailable Error