Full API Reference

All API endpoints are relative to: https://api.shadowphone.com/v1

List all connected Instagram accounts. Returns an array of account objects with id, username, follower_count, status, and paired_device information.

Create a new automation workflow. Required fields: name (string), type (string), steps (array of step objects). Optional: schedule (object), enabled (boolean).

Retrieve analytics data. Query parameters: account_id (required), start_date, end_date, metrics (comma-separated list). Returns time-series data for requested metrics.

Queue a new automation action for immediate execution. Required fields: account_id, action_type (follow/like/comment/dm), target. Returns a job_id for tracking.

List all connected phones and their current status. Returns device info including model, status, active_account, and uptime.

Delete a workflow by its ID. Returns 204 No Content on success. Active workflows are stopped before deletion.

Configure webhooks at Settings > Webhooks to receive real-time notifications for events like workflow_completed, action_blocked, device_disconnected, and more.