Actora Logo
Developer Resources

API Reference

Complete documentation for integrating Actora's quest platform, analytics, and community features into your Web3 application.

View on GitHub

v1.2.0

API Version

24

Endpoints

99.9%

Uptime

120ms

Response

Create Quest

Launch a new quest campaign with customizable tasks and rewards.

POST/v1/quests

Request Parameters

titlestringRequired

The public title of the quest

descriptionstringRequired

Detailed description of the quest objectives

projectIdstringRequired

Unique identifier of the project launching this quest

xpRewardnumberRequired

Amount of XP to award upon completion (100-10000)

tokenRewardnumberOptional

Optional token reward amount

startDatestringOptional

ISO 8601 date when quest becomes active

endDatestringOptional

ISO 8601 date when quest expires

tasksarrayRequired

Array of task objects defining completion requirements

Response (200 OK)

{
  "success": true,
  "data": {
    "id": "quest_9f8e7d6c5b4a",
    "title": "Welcome Quest",
    "status": "active",
    "xpReward": 500,
    "createdAt": "2025-11-02T10:30:00Z"
  }
}

Error Codes

400Bad Request
401Unauthorized
429Rate Limited
500Server Error
const actora = new ActoraClient({
  apiKey: process.env.ACTORA_API_KEY
});

const quest = await actora.quests.create({
  title: 'Welcome Quest',
  projectId: 'proj_abc123',
  xpReward: 500,
  tasks: [
    {
      type: 'twitter_follow',
      target: '@YourProject'
    }
  ]
});
JavaScript SDKPython SDKAPI Playground

Need Help?

Join our developer community for support and integration assistance.

Join DiscordContact Support