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 let merchants give affiliates the material they need to promote a program without sending files manually. Affiliates see only published resources for programs they belong to, and AI agents can retrieve the same material through MCP.

​
Resource model

ItemPurpose
CollectionsGroup related campaign assets, launch kits, or seasonal material. Collections are containers, not resource_type records.
fileDownloadable files such as images, videos, PDFs, or media bundles.
social_postAffiliate-ready post copy with platform tags, optional media, instructions, and disclosure guidance.
swipe_copyReusable text snippets for newsletters, posts, ads, or landing pages.
external_linkLinks to external brand folders, product pages, or campaign material.
Resources move through three statuses:
StatusMeaning
draftVisible to merchants only. Use this while preparing or reviewing material.
publishedVisible to approved affiliates and affiliate MCP clients.
archivedHidden from affiliates and removed from active merchant lists unless explicitly filtered.

​
Supported files and limits

AgentRef accepts PNG, JPEG, WebP, GIF, MP4, QuickTime, WebM, and PDF files.
LimitValue
Standard file upload50 MB
Social post image50 MB
Social post video200 MB
Total media per social post500 MB
Media attachments per social post10
Items per collection100
Storage and notification limits depend on your billing tier:
TierStorageCollectionsAffiliate notifications
Free250 MB1 collection per program0 per rolling week
Starter2 GBUnlimited2 per rolling week
Growth10 GBUnlimited5 per rolling week
Pro50 GBUnlimited10 per rolling week

​
Social post templates

Social posts can include placeholders that are rendered for each affiliate:
PlaceholderRendered value
{{affiliate_link}}The selected affiliate tracking link for the program.
{{affiliate_code}}The affiliate’s referral code.
{{program_name}}The program name.
AgentRef also returns disclosure guidance with rendered social posts. If a post includes a referral link, affiliates should include a clear disclosure such as #ad or equivalent wording that fits the platform and your policy.

​
Merchant workflow

  1. Create or select a collection for the campaign.
  2. Upload files, create social posts, add swipe copy, or attach external links.
  3. Review the material in draft status.
  4. Publish the resource when it is ready for affiliates.
  5. Optionally notify affiliates when a published resource should be used immediately.

​
Surface coverage

Marketing Resources are broader in the dashboard and MCP than they are in the REST API and SDKs. REST and SDKs currently cover listing, social posts, social-post media, status changes, notifications, and download URLs. MCP additionally exposes collection, external-link, generic file-upload, and URL-import workflows.
CapabilityDashboardREST APINode/Python SDKsMerchant MCP
List resources and get detailsYesYesYesYes
Create and update social postsYesYesYesYes
Upload, replace, reorder, and remove social-post mediaYesYesYesYes
Publish, unpublish, archive, notify affiliatesYesYesYesYes
Create merchant download URLsYesYesYesYes
Create or update collectionsYesNoNoYes
Create external linksYesNoNoYes
Generic file upload sessionsYesNoNoYes
Import a resource from a URLYesNoNoYes
Create or update swipe copyYesNoNoNo
Marketing Resources do not currently emit webhook events. Use API/MCP reads or dashboard activity when you need to inspect resource state.

​
REST API

Merchant Marketing Resources use the marketing_resources:read and marketing_resources:write scopes.
ActionEndpoint
List resourcesGET /api/v1/programs/{id}/marketing-resources
Create social postPOST /api/v1/programs/{id}/marketing-resources/social-posts
Update social postPATCH /api/v1/marketing-resources/social-posts/{resourceId}
Create media upload sessionPOST /api/v1/marketing-resources/social-posts/{resourceId}/media/upload-sessions
Complete media uploadPOST /api/v1/marketing-resources/social-posts/{resourceId}/media/complete
Update or remove mediaPATCH /api/v1/marketing-resources/social-posts/{resourceId}/media/{mediaId} or DELETE /api/v1/marketing-resources/social-posts/{resourceId}/media/{mediaId}
Reorder mediaPOST /api/v1/marketing-resources/social-posts/{resourceId}/media/reorder
Replace mediaPOST /api/v1/marketing-resources/social-posts/{resourceId}/media/{mediaId}/replace
Publish, unpublish, archive, notifyPOST /api/v1/marketing-resources/{resourceId}/{action}
Create download URLPOST /api/v1/marketing-resources/download-url
curl "https://www.agentref.co/api/v1/programs/PROGRAM_ID/marketing-resources?kind=social_posts&status=published" \
  -H "Authorization: Bearer ak_live_YOUR_KEY"

​
MCP tools

Merchant MCP exposes the richest Marketing Resources workflow: list_marketing_resources, get_marketing_resource, create_marketing_collection, update_marketing_collection, publish_marketing_resource, unpublish_marketing_resource, archive_marketing_resource, create_marketing_social_post, update_marketing_social_post, create_marketing_social_post_media_upload_session, complete_marketing_social_post_media_upload, remove_marketing_social_post_media, update_marketing_social_post_media, reorder_marketing_social_post_media, replace_marketing_social_post_media, create_marketing_resource_download_url, create_marketing_external_link, create_marketing_upload_session, complete_marketing_upload_session, import_marketing_resource_from_url, and notify_marketing_resource_affiliates. Use the merchant MCP endpoint for these tools: 
https://www.agentref.co/api/mcp/merchant

​
What’s next

MCP Server

Use AI agents to create, publish, and retrieve marketing resources.

Affiliate Marketing Resources

See what affiliates can access and render.