Agent

Create an emailless agent account

Changed on

Creates an emailless agent account without authentication and returns a one-time API key (prefixed prim_) plus a provisioned managed inbox. The account is on the agent plan: reply-only (it can send only to addresses that have already sent it authenticated mail) with tight send limits. Use the returned api_key as a Bearer token on later calls. The account can be upgraded to a full developer account by confirming an email through the claim flow. Upgrading raises the send cap and grants the developer plan's default features (such as Functions); it does not unlock sending to arbitrary recipients, because the recipient rules on the account still apply. GET /send-permissions reports those rules (its list of individual addresses can be partial), and POST /sendability answers for one specific recipient. This endpoint does not require an API key.

post/agent/accounts

Request

  • Base URL: https://api.primitive.dev/v1
  • URL: https://api.primitive.dev/v1/agent/accounts
  • Auth: none required

Request body

terms_acceptedtrue required

Must be true to accept the Terms of Service and Privacy Policy.

device_namestring

Optional label for the device or agent creating the account.

Response

Agent account created; the API key is returned once

successboolean required

Changes

  • 52138fa51360Revision changes
    • info

      removed the invalid_signup_code enum value from the / response property for the response status

    • info

      removed the invalid_signup_code enum value from the / response property for the response status

  • 22d1dfc68434Revision changes
    • warning

      added the new not_a_repeating_send enum value to the / response property for the response status

    • warning

      added the new not_a_repeating_send enum value to the / response property for the response status

    • warning

      added the new repeat_idle_requires_internal_recipient enum value to the / response property for the response status

    • warning

      added the new repeat_idle_requires_internal_recipient enum value to the / response property for the response status

    • warning

      added the new repeat_recipient_external enum value to the / response property for the response status

    • warning

      added the new repeat_recipient_external enum value to the / response property for the response status

    • warning

      added the new repeat_stop_not_allowed enum value to the / response property for the response status

    • warning

      added the new repeat_stop_not_allowed enum value to the / response property for the response status

    • warning

      added the new repeat_unsupported enum value to the / response property for the response status

    • warning

      added the new repeat_unsupported enum value to the / response property for the response status