List all organizations associated with your API key.

Use this to find your Organization ID (org_id) required for all social media and CRM tools. You can also set YAPARAI_ORG_ID env var to avoid passing it every time.

Returns: List of organizations with id, name, plan, and member count.

List connected social media accounts (Instagram, Facebook, TikTok, X/Twitter).

Shows all social accounts linked to the organization with their status, username, and follower count. Requires enterprise subscription.

Create and publish (or schedule) a social media post.

Supports text, images, and videos on Instagram, Facebook, TikTok, X. Use scheduled_at to queue posts for a future time.

List published and scheduled social media posts.

Returns all posts for the organization with engagement stats. Supports filtering by platform, account, or post status.

Delete a social media post.

Deletes the post from both the YaparAI platform and the social media platform (if supported by the platform's API). Scheduled posts are cancelled.

Get social media analytics and performance metrics.

Returns engagement stats, follower growth, reach, and impressions for your social media accounts over a given time period.

Generate an AI-powered social media caption.

Creates engaging, platform-optimized captions using AI. Supports Turkish and English, multiple tones.

Generate AI-optimized hashtags for a social media post.

Creates relevant, trending hashtags based on caption content.

List social media inbox conversations (DMs and comments).

Shows all incoming messages from Instagram, Facebook, WhatsApp, etc. Optionally filter by platform or unread status.

Read all messages in a social media conversation.

Get the full message history of a DM or comment thread.

Reply to a social media DM or message.

Send a reply in an existing conversation on Instagram, Facebook, WhatsApp, or other connected platforms.

Get an AI-generated reply suggestion for a conversation.

The AI reads the full conversation context and suggests an appropriate, personalized reply. Customize with a system prompt.

Get social media quota and usage limits for the current billing period.

Returns remaining post quota, message limits, and when the period resets. Useful before running bulk operations.

List CRM customers with optional filtering.

Browse the customer database built from social media conversations. Filter by name/email/phone search, platform source, or tags.

Get detailed information about a specific customer.

Returns full customer profile including contact details, tags, notes, conversation history summary, and order information.

Manually create a new CRM customer record.

Add a customer who may not have come through the social inbox. Useful for migrating existing customers or adding offline contacts.

Update an existing customer's information.

Partially update a customer record — only provided fields are changed. Tags replace the existing tag list completely.

Add a note to a customer's record.

Notes are visible in the customer profile and help your team track important context (order issues, preferences, follow-ups, etc.).

Extract contact information from conversation history using AI.

The AI reads all messages with this customer and extracts their name, phone number, email, and address. Great for auto-filling CRM records.

Send shipping and tracking information to a customer.

Automatically sends a tracking message through the same social platform the customer used to contact you (Instagram DM, WhatsApp, etc.).

Send a message to multiple customers at once.

Broadcast promotions, announcements, or updates. Target by specific IDs, a customer tag, or a platform. At least one of customer_ids, tag, or platform is required.

Import customers from social media inbox conversations.

Scans all inbox conversations and creates CRM customer records for everyone who has messaged you. New customers are auto-tagged by platform. Existing customers are not duplicated.