BOOK A DEMO

Introduction

Getting Started

Create your account, link a business account, and start calling the Basta GraphQL APIs.

Step 1: Create your user account

Head over to dashboard.basta.app and sign up. Once you've signed up, your personal user account will be created.

Step 2: Set up your business account

To access the API, your user must be linked to a business account.

Email us at hi@basta.app after you log in, and we'll:

  • Create a business account for your company
  • Link it to your user
  • Enable access to production APIs

Step 3: Get API access

Once your business account is live, you'll be able to:

  • Generate API keys
  • Start exploring our GraphQL endpoints

API access

Step 1: Sign up & log in

  1. Create your user account at dashboard.basta.app
  2. You'll receive your Account ID once your business account is activated
  3. Log into the dashboard to create an API key

If you haven't received your Account ID yet, contact us at hi@basta.app

Step 2: Generate an API key

Once logged in, navigate to your dashboard's Settings section to generate an API key. You'll use this key to authenticate your GraphQL requests.

Step 3: Set request headers

All requests to the Management API must include these headers:

JSON
{
  "x-account-id": "YOUR_ACCOUNT_ID",
  "x-api-key": "YOUR_API_KEY"
}

These headers are required for both authenticated queries and mutations.

Example request

Shell
curl -X POST https://management-api.basta.app/graphql \
  -H "Content-Type: application/json" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"query": "{ __typename }"}'
JavaScript
// JavaScript/TypeScript example
const response = await fetch('https://management-api.basta.app/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-account-id': 'YOUR_ACCOUNT_ID',
    'x-api-key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    query: `
      query {
        # Your GraphQL query here
      }
    `
  })
});
Ruby
# Ruby example
require 'net/http'
require 'json'

uri = URI('https://management-api.basta.app/graphql')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['x-account-id'] = 'YOUR_ACCOUNT_ID'
request['x-api-key'] = 'YOUR_API_KEY'
request.body = JSON.generate({
  query: '{ __typename }'
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

What's next?