Follow these steps to go from a brand-new account to your first NPC conversation.
Active plan required:API & SDK usage need an NPC Builder subscription.View plans & pricing.

​
In-app setup

1

Create a game

Sign in at app.npcbuilder.comand click Create Game.
Copy the generated GAME_ID.
2

Add a world

Inside the game, click Add World; fill name and lore.
Copy the WORLD_ID.
3

Add region & location

Open your world → Add Region(e.g. “Northern Kingdom”) →
inside that region, Add Location(e.g. “Capital City”).
4

Create a character

In the location, click Add Character→ fill name, description, role, traits, etc.
Save; note the character_nameto use in the API.
5

Chat in dashboard

On the character page, open the Chattab and send a test message—confirm the NPC responds.

​
Generate credentials

1

Bearer token (quick)

Go to Developers → API Tokens→ Generate Bearer Token.
Use in header:
Authorization: Bearer YOUR_TOKEN
2

API keys (production)

Still in Developers, create an API Keypair.
Use in headers:
{
  "clientId": "API_KEY_ID",
  "clientSecret": "API_KEY_SECRET"
}

​
Call the Interactions API

curl -X POST https://app.npcbuilder.com/api/interactions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "character_name": "Guardian NPC",
    "game_id": "GAME_ID",
    "world_id": "WORLD_ID",
    "messages": [
      { "role": "user", "content": "Hello!" }
    ]
  }'

​
Expected JSON

{
  "response": "Greetings, traveler!",
  "user_events": [],
  "character_events": []
}
Unity and Unreal plugins wrap these calls—see Unity or Unreal guides.