Autohost

Autohost Accounts API

The Accounts API from Autohost — 7 operation(s) for accounts.

Documentation GitHub OpenAPI

Operations 8

GET /accounts/me My account #

GET /accounts/children Reseller accounts list #

GET /accounts/keys Reseller API keys #

POST /accounts/register Reseller new account #

PUT /accounts/{id} Reseller update account #

POST /accounts/webhooks Account create webhook #

DELETE /accounts/webhooks Account remove webhook #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/autohost:autohost-accounts-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Autohost Accounts API
  version: '1'
  description: 'Operations tagged Accounts across 2 of this provider''s published API definitions: autohost-openapi.json, developer.autohost.ai_openapi.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Accounts
paths:
  /accounts/me:
    get:
      operationId: accounts-me
      summary: My account
      description: Return current user account information. This is often used to validate authentication.
      parameters:
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: A user object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountDetailsResponse'
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Accounts
  /accounts/children:
    get:
      operationId: accounts-children
      summary: Reseller accounts list
      description: Paginated list of user accounts belonging to a reseller profile.
      parameters:
      - name: from
        in: query
        description: Pagination control
        required: false
        allowEmptyValue: false
        schema:
          type: number
      - name: size
        in: query
        description: Number of items to return
        required: false
        allowEmptyValue: false
        schema:
          type: number
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: A list of account objects
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountChildrenResponse'
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Accounts
  /accounts/keys:
    get:
      operationId: accounts-keys
      summary: Reseller API keys
      description: List of API keys for all accounts owned by a reseller.
      parameters:
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: A list of account objects
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountApiKeysResponse'
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Accounts
  /accounts/register:
    post:
      operationId: accounts-register
      summary: Reseller new account
      description: Register a new account under a channel profile. This is used by resellers and channel partners to create Autohost user accounts.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountRegistrationRequest'
        description: JSON object with user account details
      parameters:
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: A user object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountDetailsResponse'
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Accounts
  /accounts/{id}:
    put:
      operationId: accounts-update
      summary: Reseller update account
      description: Update a channel account. This is used by resellers and channel partners to update Autohost user accounts.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountRegistrationRequest'
        description: JSON object with user account details
      parameters:
      - name: id
        in: path
        description: Autohost user ID
        required: true
        schema:
          type: string
      - name: suspended
        in: query
        description: Suspend or unsuspend the account
        required: false
        allowEmptyValue: false
        schema:
          type: string
          enum:
          - 'true'
          - 'false'
      - name: status
        in: query
        description: Enable or disable the account
        required: false
        allowEmptyValue: false
        schema:
          type: string
          enum:
          - active
          - disabled
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: User account object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountDetailsResponse'
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Accounts
  /accounts/signup:
    post:
      operationId: accounts-signup
      summary: Reseller signup link
      description: Generate a self-signup link for a given PMS. This is used by resellers and channel partners to create registration links they can send to their customers.
      parameters:
      - name: pms
        in: query
        description: PMS integration name
        required: true
        allowEmptyValue: false
        schema:
          $ref: '#/components/schemas/QueryParamPMS'
      - name: redirect
        in: query
        description: URL to redirect to after signup
        required: false
        allowEmptyValue: false
        schema:
          type: string
      - name: hidepw
        in: query
        description: Hide password screen during user signup
        required: false
        allowEmptyValue: false
        schema:
          type: string
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: A signup object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountSignupLinkResponse'
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Accounts
  /accounts/webhooks:
    post:
      operationId: accounts-webhooks-create
      summary: Account create webhook
      description: Register a new webhook. This is used by platforms such as Zapier to register webhooks.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountWebhooksRequest'
        description: JSON object with webhook details
      parameters:
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Webhooks object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountWebhooksResponse'
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Accounts
    delete:
      operationId: accounts-webhooks-delete
      summary: Account remove webhook
      description: Delete an existing webhook. This is used by platforms such as Zapier to unregister webhooks.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountWebhooksRequest'
        description: JSON object with webhook details
      parameters:
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Webhooks object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountWebhooksResponse'
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Accounts
components:
  schemas:
    AccountDetailsResponse:
      properties:
        id:
          type: string
        name:
          type: string
        email:
          type: string
          format: email
        phone:
          type: string
        is_active:
          type: boolean
        is_suspended:
          type: boolean
        last_login:
          type: string
          format: date-time
        created_at:
          type: string
          format: date-time
        company:
          type: object
          properties:
            name:
              type: string
            email:
              type: string
              format: email
            phone:
              type: string
        billing:
          type: object
          properties:
            parent_account:
              type: string
    QueryParamPMS:
      type: string
      enum:
      - api
      - apaleo
      - beds24
      - booking
      - cloudbeds
      - guesty
      - hostaway
      - hostfully
      - inforhms
      - impala
      - lavanda
      - myvr
      - opera
      - smartbnb
      - stayntouch
      - streamline
      - trackhs
    AccountWebhooksRequest:
      properties:
        webhook_url:
          type: string
          format: uri
        webhook_key:
          type: string
          enum:
          - guest_portal_webhook_url
          - screening_webhook_url
          - stargate_webhook_url
          - reservation_webhook_url
          - listing_webhook_url
          - account_webhook_url
    AccountWebhooksResponse:
      properties:
        message:
          type: string
    AccountSignupLinkResponse:
      properties:
        url:
          type: string
          format: uri
        expiry:
          type: string
          format: date-time
    ErrorResponse:
      properties:
        error:
          type: string
    AccountApiKeysResponse:
      type: array
      items:
        type: object
        properties:
          user_id:
            type: string
          user_name:
            type: string
          value:
            type: string
    AccountRegistrationRequest:
      properties:
        name:
          type: string
        email:
          type: string
          format: email
        phone:
          type: string
        password:
          type: string
        company:
          type: object
          properties:
            name:
              type: string
            email:
              type: string
              format: email
            phone:
              type: string
    AccountChildrenResponse:
      properties:
        from:
          type: number
        size:
          type: number
        total:
          type: number
        items:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              name:
                type: string
              email:
                type: string
                format: email
              phone:
                type: string
x-refined-from:
- autohost-openapi.json
- developer.autohost.ai_openapi.json