Signup

Poll signup handoff status

Pollable status feed for AI agents that started a posterly signup (a 7-day card-backed free trial). While checkout is open, the response includes payment: trial terms, merchant and what an agent may do. payment is null once the card is saved or checkout has expired. A completed trial Checkout reports status password_required, payment_confirmed or later; the statuses are unchanged and their messages say the trial started and the card is saved. Use status_message and next_action to keep the user informed in the AI chat while Stripe checkout, password setup, and agent authorization happen in the browser. If the session returns agent_access_required, the user must copy/install/authorize posterly access in the trusted AI before the agent can create connect sessions. When the agent actually has posterly access, ask which social account to connect, call create_connect_session, send the connect_url, and poll the connect session.

get/api/v1/signup/sessions/{session_id}

Request

  • Base URL: https://www.poster.ly
  • URL: https://www.poster.ly/api/v1/signup/sessions/{session_id}
  • Auth: none required

Path parameters

session_idstring required

Stripe checkout session ID returned by POST /api/v1/signup.

Response

Signup session status fetched successfully

Example response

{
  "signup_session": {
    "agent_pay": {
      "currency": "usd",
      "amount_display": "$10.00"
    },
    "payment": {
      "currency": "usd",
      "amount_display": "$10.00",
      "description": "posterly Starter plan + API access, billed monthly, with a 7-day free trial (card required, charged on day 8)",
      "merchant_name": "posterly",
      "merchant_url": "https://www.poster.ly"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.