Skip to content

Quick Start

This guide gets you from zero to a running content mission in under 5 minutes.

Prerequisites

  • An AMP account (sign up)
  • At least one connected social platform via Metricool

Step 1: Get Your API Key

Navigate to Settings → API Keys in the AMP dashboard and create a new key:

export AMP_API_KEY="amp_live_xxxxxxxxxxxxxxxxxxxxx"

Key Security

Store your API key securely. Never commit it to version control or expose it in client-side code.

Step 2: Connect a Platform

Before creating content, connect at least one publishing destination.

  1. Go to Integrations → Metricool
  2. Enter your Metricool API token
  3. Select the brand/accounts to connect
curl -X POST https://api.amp.dev/v1/connect/metricool \
  -H "Authorization: Bearer $AMP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "your_metricool_token",
    "blog_id": "your_blog_id"
  }'

Step 3: Set Up Brand Context

AMP needs to understand your brand to generate on-brand content. The fastest way is automatic extraction:

curl -X POST https://api.amp.dev/v1/onboard/quick \
  -H "Authorization: Bearer $AMP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "website_url": "https://yourcompany.com",
    "platforms": ["twitter", "linkedin"]
  }'

This scrapes your website, analyzes your existing content, and builds a brand context including:

  • Voice and tone profile
  • Visual identity guidelines
  • Key messaging and topics
  • Competitor positioning

Step 4: Create Your First Mission

Now create a mission to start generating content:

curl -X POST https://api.amp.dev/v1/missions \
  -H "Authorization: Bearer $AMP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Weekly Thought Leadership",
    "objectives": [
      "Establish expertise in our domain",
      "Drive traffic to blog content"
    ],
    "platforms": ["twitter", "linkedin"],
    "constraints": {
      "tone": "professional yet approachable",
      "cadence": "daily",
      "excluded_topics": ["politics", "competitors"]
    },
    "kpis": [
      {
        "metric": "engagement_rate",
        "target": 3.5
      },
      {
        "metric": "impressions",
        "target": 10000
      }
    ],
    "duration_days": 30
  }'
Response
{
  "id": "msn_2xK9mPqR4vN8sT3w",
  "name": "Weekly Thought Leadership",
  "status": "active",
  "pipeline_job_id": "job_7yH3nLqW5xM2pK9v",
  "platforms": ["twitter", "linkedin"],
  "created_at": "2024-01-15T10:30:00Z",
  "estimated_first_content_at": "2024-01-15T11:00:00Z"
}

Step 5: Monitor Progress

Check your mission status and generated content:

curl https://api.amp.dev/v1/missions/msn_2xK9mPqR4vN8sT3w/status \
  -H "Authorization: Bearer $AMP_API_KEY"
{
  "mission_id": "msn_2xK9mPqR4vN8sT3w",
  "status": "active",
  "pipeline_stage": "content",
  "content_generated": 5,
  "content_published": 2,
  "next_publish_at": "2024-01-16T09:00:00Z"
}
curl "https://api.amp.dev/v1/content?mission_id=msn_2xK9mPqR4vN8sT3w" \
  -H "Authorization: Bearer $AMP_API_KEY"
{
  "data": [
    {
      "id": "cnt_4pL8mNqR7vX2sW9k",
      "status": "scheduled",
      "platform": "twitter",
      "copy": {
        "primary": "The future of marketing isn't about more content—it's about smarter content. Here's what we've learned...",
        "hashtags": ["#MarketingTips", "#AI"]
      },
      "scheduled_for": "2024-01-16T09:00:00Z"
    }
  ],
  "has_more": true
}

Step 6: Review and Approve (Optional)

By default, AMP auto-approves generated content. To require manual approval:

# Update mission to require approval
curl -X PUT https://api.amp.dev/v1/missions/msn_2xK9mPqR4vN8sT3w \
  -H "Authorization: Bearer $AMP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "constraints": {
      "require_approval": true
    }
  }'

Then approve content individually:

curl -X POST https://api.amp.dev/v1/content/cnt_4pL8mNqR7vX2sW9k/approve \
  -H "Authorization: Bearer $AMP_API_KEY"

What's Next?

  • Define Better Missions

    Learn how to craft missions with precise objectives and constraints.

    Creating Missions

  • Configure Your Brand

    Fine-tune your brand context for better content generation.

    Brand Configuration

  • Explore the API

    Full reference for all available endpoints.

    API Reference