API access for Team and Custom plans

Overview

Flikly Developer API v1 gives Team and Custom plan customers programmatic access to video generation, split jobs, asset management, webhooks, and usage tracking. Access is managed through the Developer Portal at developers.flikly.ai.

The Developer API uses the same Flikly account and credit balance as the main app. API keys, webhooks, usage dashboards, and documentation live on the Developer Portal subdomain.

Who can use the Developer API?

Team plan: Developer API access is included.
Custom plan: Developer API access is included, with custom limits and support as negotiated.
Free, Creator, and Pro plans: not included in Developer API v1.
If access is denied, upgrade or change your plan from Flikly billing or the pricing page.

See Free, Creator, Pro, Team, and Custom plans and Upgrading or changing plan for plan details.

Where do I manage API access?

Go to developers.flikly.ai and sign in with the same Flikly account you use on flikly.ai.
The Developer Portal runs on a separate subdomain and session from the main app.
From the portal, manage API keys, webhooks, usage, and read API documentation.

What can I do with the API in V1?

Developer API v1 includes:

Create and manage uploaded assets
Create AI video jobs
Create split/clip jobs from uploaded video assets
List and inspect jobs (unified jobs API)
Configure webhooks for job.completed and job.failed
View usage, credits, and rate limits

What is not available in V1?

The following are not part of Developer API v1:

Pro Limited API
Free or Creator API access
Social publishing API
Ads API
Split jobs from URL or YouTube links
SDK packages
Job cancel or retry API endpoints
Auto-recharge charging (not available yet)

How billing and credits work

Developer API uses the same Flikly credit balance as your account or organization.
Credits are consumed for eligible AI video and split jobs.
Asset upload, job reads, usage reads, and webhook management do not consume credits.
If credits are insufficient, the API rejects the job before work starts.
Buy more credits in the main Flikly app billing area when you need additional capacity.
Auto-recharge charging is not available yet for Developer API usage.

Manage credits in Dashboard → Settings → Billing. See How credits work by plan for credit rules by plan.

API keys and security

Create API keys in the Developer Portal under API Keys.
The secret value is shown once at creation—store it immediately.
Store API keys server-side only. Never embed keys in browser or mobile client code.
Revoke and rotate keys promptly if a key may have been exposed.

Treat API keys like passwords. Use them only from trusted backend services, not from front-end JavaScript, mobile apps, or public repositories.

Webhooks

Configure webhooks in the Developer Portal.
Supported events: job.completed and job.failed.
Webhook payloads include API result paths—not signed storage URLs.
Verify webhook signatures using the documentation examples before trusting payloads.

See the webhooks documentation on the Developer Portal for setup and signature verification.

Documentation

Official Developer API resources:

Developer Portal: developers.flikly.ai
API docs: developers.flikly.ai/docs
OpenAPI spec: flikly-developer-api-v1.yaml

Troubleshooting

Why is Developer API access denied?

Your plan may not be eligible (Team or Custom required), or your subscription may be inactive. Upgrade or change plan from Flikly billing or the pricing page. View pricing or manage billing.

Why did my job fail with insufficient credits?

Developer API jobs use the same credit balance as your Flikly account. Buy more credits in the main app billing area before retrying. Buy credits in billing.

Why am I rate limited?

Developer API requests are subject to plan rate limits. Retry after the Retry-After header value returned by the API.

Why are my webhooks failing?

Check webhook delivery status in the Developer Portal. Verify your endpoint URL, signature verification, and that your server returns a 2xx response.

Is Pro API access available?

No. Developer API v1 is available on Team and Custom plans only. Pro Limited API is not part of v1.