API Reference
Access Wonderful's REST and GraphQL APIs (Enterprise feature) to integrate with your existing tools, automate workflows, and build custom solutions on top of the platform.
Enterprise Feature: API access is available exclusively for Wonderful Enterprise customers. Contact sales to upgrade and request API credentials.
Wonderful provides comprehensive REST and GraphQL APIs that enable Enterprise customers to integrate the platform with their existing tools, automate workflows, and build custom solutions. This guide provides an overview of API capabilities, authentication, and common use cases.
The Wonderful API provides programmatic access to:
- Workspaces and Teams: Create and manage organizational structure
- Assets: Upload, organize, and retrieve digital assets
- Tasks and Workflows: Automate approval processes
- Campaigns: Create and manage ad campaigns
- Products: Sync product catalogs (Shopify integration)
- Users: Manage team members and permissions
- Analytics: Retrieve performance metrics
- Webhooks: Receive real-time event notifications
REST API:
- Traditional REST endpoints
- JSON request/response format
- HTTP methods (GET, POST, PUT, PATCH, DELETE)
- Best for simple integrations
- Comprehensive documentation
GraphQL API:
- Flexible query language
- Request exactly the data you need
- Single endpoint for all operations
- Efficient for complex data requirements
- Interactive GraphQL Playground
Webhooks:
- Real-time event notifications
- Push data to your systems
- No polling required
- Configurable event types
Common Integration Scenarios:
- DAM Integration: Sync assets between Wonderful and other systems
- Workflow Automation: Trigger actions based on task status
- Product Sync: Keep product catalogs in sync across platforms
- Custom Reporting: Pull data for custom analytics dashboards
- Campaign Automation: Programmatically create and manage campaigns
- User Provisioning: Automate team member onboarding/offboarding
- Asset Generation: Generate ads programmatically
- Content Approval: Integrate with existing approval systems
Enterprise Customers:
- Contact your account manager or email api@usewonderful.com
- Describe your integration use case
- Receive API credentials and documentation access
- Get added to developer Slack channel for support
