Request your first test offer

This flow is designed for a publisher to create an app, copy a test key, and receive a labeled offer in under 10 minutes.

1. Create a publisher app

Register the agent or assistant surface, choose framework metadata, and create at least one placement ID.

2. Use a test API key

New keys start in test mode and return deterministic offers until production approval is complete.

3. Call the offer API beside your AI request

await genesis.requestOffers({
  testMode: true,
  placement: {
    placementId: "chat_recommendation_after_answer",
    appId: "app_docs_quickstart",
    agentType: "conversational_assistant",
    surface: "chat"
  },
  context: {
    userMessage: "I need SOC 2 monitoring for a seed-stage SaaS.",
    intentKeywords: ["soc2", "monitoring"],
    categories: ["security_compliance"],
    country: "US"
  },
  user: {
    sessionId: "session_docs_123456"
  },
  controls: {
    maxOffers: 2,
    requireDisclosure: true
  }
});