Skip to content

Onboarding Guide

This guide walks you through the complete onboarding process, from account creation to your first published content.

Overview

Onboarding consists of four main steps:

  1. Account Setup — Create your account and tenant
  2. Brand Context — Configure your brand identity
  3. Platform Connection — Connect publishing destinations
  4. First Mission — Launch your first content campaign

Step 1: Account Setup

Create Your Account

Sign up at app.amp.dev/signup using your work email.

After email verification, you'll be prompted to:

  1. Enter your organization name
  2. Choose a tenant slug (used in URLs)
  3. Select your primary use case

Invite Team Members

Navigate to Settings → Team to invite colleagues:

curl -X POST https://api.amp.dev/v1/tenants/current/users \
  -H "Authorization: Bearer $AMP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "colleague@yourcompany.com",
    "role": "operator"
  }'

Roles:

Role Capabilities
admin Full access including settings
operator Manage missions and content
viewer View-only access

Step 2: Brand Context

Brand context is critical for generating on-brand content. You have two options:

Let AMP analyze your existing presence:

curl -X POST https://api.amp.dev/v1/onboard \
  -H "Authorization: Bearer $AMP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "website_url": "https://yourcompany.com",
    "social_profiles": {
      "twitter": "https://twitter.com/yourcompany",
      "linkedin": "https://linkedin.com/company/yourcompany"
    },
    "analyze_competitors": true,
    "industry": "developer_tools"
  }'

This process:

  1. Scrapes your website for messaging and visual identity
  2. Analyzes your social media history for voice patterns
  3. Identifies key topics and content themes
  4. Extracts color palette and image style

Monitor progress:

curl https://api.amp.dev/v1/onboard/{id}/stream \
  -H "Authorization: Bearer $AMP_API_KEY"

Option B: Manual Configuration

For precise control, configure brand context manually:

curl -X POST https://api.amp.dev/v1/brand \
  -H "Authorization: Bearer $AMP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice": {
      "tone": "professional yet approachable",
      "personality": ["knowledgeable", "helpful", "direct"],
      "writing_style": "Clear, concise sentences. Active voice."
    },
    "visual_identity": {
      "primary_color": "#7c3aed",
      "image_style": "modern, clean, tech-focused"
    },
    "content_guidelines": {
      "topics": ["developer productivity", "API design"],
      "excluded_topics": ["politics", "competitors"]
    }
  }'

Review and Refine

After extraction, review the generated brand context:

curl https://api.amp.dev/v1/brand \
  -H "Authorization: Bearer $AMP_API_KEY"

Make adjustments as needed:

curl -X PUT https://api.amp.dev/v1/brand/{id} \
  -H "Authorization: Bearer $AMP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice": {
      "tone": "more casual than detected"
    }
  }'

Step 3: Platform Connection

Connect Metricool

AMP uses Metricool for multi-platform publishing. You'll need:

  1. A Metricool account (free tier available)
  2. Your Metricool API token
  3. At least one connected social platform in Metricool
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"
  }'

Verify Connections

Check which platforms are available:

curl https://api.amp.dev/v1/connect/metricool/accounts \
  -H "Authorization: Bearer $AMP_API_KEY"

{
  "data": [
    {"platform": "twitter", "username": "@yourcompany", "status": "active"},
    {"platform": "linkedin", "username": "Your Company", "status": "active"}
  ]
}

Step 4: First Mission

Create a Simple Mission

Start with a focused, short-duration mission:

curl -X POST https://api.amp.dev/v1/missions \
  -H "Authorization: Bearer $AMP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Getting Started",
    "objectives": ["Test content generation quality"],
    "platforms": ["twitter"],
    "constraints": {
      "cadence": "daily",
      "posts_per_day": 1,
      "require_approval": true
    },
    "duration_days": 7,
    "start_immediately": true
  }'

Monitor Progress

Watch the pipeline execute:

curl https://api.amp.dev/v1/missions/{id}/status \
  -H "Authorization: Bearer $AMP_API_KEY"

Review Generated Content

Once content is generated, review it:

curl https://api.amp.dev/v1/content?mission_id={id} \
  -H "Authorization: Bearer $AMP_API_KEY"

Approve and Publish

If content looks good, approve it:

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

Onboarding Checklist

  • Account created and verified
  • Tenant configured with name and slug
  • Team members invited (if applicable)
  • Brand context extracted or configured
  • Metricool connected
  • At least one social platform active
  • First mission created
  • First content reviewed and approved
  • First post published

Common Issues

Brand context seems off

The automatic extraction might need refinement. Review the generated context and make specific adjustments to voice.tone or add more examples in examples.good_posts.

No platforms showing

Ensure your Metricool account has platforms connected. AMP can only publish to platforms you've connected in Metricool.

Content quality not meeting expectations

Try:

  1. Adding more detailed writing_style guidelines
  2. Including good_posts examples
  3. Adding specific excluded_topics
  4. Refining your objectives to be more specific

Next Steps