API Documentation

Build powerful integrations with Vibefy's comprehensive REST API. Access all features programmatically.

Quick Start

Get up and running with the Vibefy API in minutes

Authentication

All API requests require authentication using your API key in the Authorization header.

Authorization: Bearer your-api-key-here

Base URL

All API endpoints are available under the following base URL:

https://vibefy.online/api/v1/

Example API Request

Get a list of your social media posts:

curl -X GET "https://vibefy.online/api/v1/posts" \

-H "Authorization: Bearer your-api-key" \

-H "Content-Type: application/json"

API Endpoints

Complete reference for all available API endpoints

Posts API

Manage social media posts and content

GET /posts

List all posts

POST /posts

Create new post

GET /posts/{id}

Get specific post

PUT /posts/{id}

Update post

AI Personas API

Manage AI personas and content generation

GET /personas

List all personas

POST /personas

Create new persona

POST /personas/{id}/generate

Generate content

PUT /personas/{id}/train

Train with new content

Social Accounts API

Manage connected social media accounts

GET /accounts

List connected accounts

POST /accounts

Connect new account

DELETE /accounts/{id}

Disconnect account

GET /accounts/{id}/metrics

Get account metrics

Scheduling API

Manage content scheduling and automation

GET /schedules

List all schedules

POST /schedules

Create new schedule

PUT /schedules/{id}

Update schedule

POST /schedules/{id}/execute

Execute schedule

Webhooks

Get real-time notifications about events in your Vibefy account

Supported Events

post.published - When a post is successfully published
post.failed - When a post fails to publish
account.connected - When a new account is connected
analytics.updated - When analytics data is refreshed
persona.trained - When AI persona training completes

Webhook Configuration

Endpoint URL

Your webhook endpoint must accept POST requests and return a 200 status code.

Security

All webhooks include an X-Vibefy-Signature header for verification.

Retry Policy

Failed deliveries are retried up to 5 times with exponential backoff.

SDKs & Libraries

Official libraries to speed up your integration

JavaScript/Node.js

Official SDK for JavaScript and Node.js applications.

Python

Python SDK for data science and automation workflows.

PHP

PHP library for web applications and CMS integrations.

Rate Limits

API usage limits and best practices

Rate Limits by Plan

Free100 requests/hour

Creator1,000 requests/hour

Pro5,000 requests/hour

EnterpriseCustom limits

Best Practices

Use Webhooks

Reduce API calls by using webhooks for real-time updates.

Implement Caching

Cache frequently accessed data to reduce API usage.

Handle Errors Gracefully

Implement proper error handling and retry logic.

Need Help?

Our developer community and support team are here to help you build amazing integrations.