Skip to main content

Documentation Index

Fetch the complete documentation index at: https://agentref.co/docs/llms.txt

Use this file to discover all available pages before exploring further.

Marketing Resources are affiliate-ready assets published by a merchant. They can include files, social post templates, swipe copy, external links, and campaign collections. You only see resources for programs where you are an approved affiliate.

What you can access

ResourceHow to use it
FilesDownload images, PDFs, videos, or other campaign assets.
Social postsRender post copy with your own affiliate link and referral code.
Swipe copyCopy approved messaging for emails, posts, or landing pages.
External linksOpen merchant-hosted folders, brand kits, or campaign pages.
CollectionsDownload or browse a grouped set of resources for a launch or campaign.

Surface coverage

Affiliate REST, SDK, and MCP access is read-oriented. Affiliates can list published resources, inspect a resource, render social post templates, and create download URLs. Creating or editing merchant resources is a merchant-only workflow.
CapabilityDashboardREST APINode/Python SDKsAffiliate MCP
List published resources for a joined programYesYesYesYes
Get resource detailYesYesYesYes
Render social post placeholdersYesYesYesYes
Create download URLsYesYesYesYes
Create or edit resourcesNoNoNoNo
Marketing Resources do not currently emit webhook events. Merchants publish or unpublish resources, and affiliates read the current published state.

Rendered social posts

Merchants can publish social post templates with placeholders:
PlaceholderRendered value
{{affiliate_link}}Your tracking link for the program.
{{affiliate_code}}Your referral code.
{{program_name}}The program name.
When you render a social post, AgentRef returns the final copy, available links, attached media, merchant instructions, and disclosure guidance.
If you share a post with your affiliate link, include a clear disclosure where people can see it. Examples include #ad, affiliate link, or equivalent wording that fits the platform and local rules.

REST API

Affiliate Marketing Resources require an affiliate API key (ak_aff_*) with marketing_resources:read.
ActionEndpoint
List resources for a programGET /api/v1/me/programs/{programId}/marketing-resources
Get resource detailGET /api/v1/me/marketing-resources/{resourceId}?program_id=PROGRAM_ID
Render social postPOST /api/v1/me/marketing-resources/social-posts/{resourceId}/render
Create download URLPOST /api/v1/me/marketing-resources/download-url
curl "https://www.agentref.co/api/v1/me/programs/PROGRAM_ID/marketing-resources?kind=social_posts" \
  -H "Authorization: Bearer ak_aff_YOUR_KEY"

MCP tools

Affiliate MCP exposes Marketing Resources through: list_marketing_resources, get_marketing_resource, render_marketing_social_post, and create_marketing_resource_download_url. Use the affiliate MCP endpoint:
https://www.agentref.co/api/mcp/affiliate

What’s next

Links & Attribution

Create and use tracking links.

Commissions

Understand how earnings are calculated.