API ReferenceBuild with the
Build with the
ShadowPhone API
Programmatically control your automation workflows. Our REST API gives you full access to accounts, workflows, analytics, and more.
Real-time Events
Webhooks for instant notifications on workflow events
Secure Auth
API keys with granular permission scoping
SDKs
Official libraries for Python, Node.js, and Go
Base URL
https://api.shadowphone.com/v1Example Request
JavaScript
// Example: Create a new follow workflow
const response = await fetch('https://api.shadowphone.com/v1/workflows', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Follow Competitors Followers',
type: 'follow',
target: {
source: 'competitors_followers',
accounts: ['@competitor1', '@competitor2'],
limit: 50
},
schedule: {
frequency: 'daily',
timezone: 'America/New_York'
}
})
});
const workflow = await response.json();
console.log('Created workflow:', workflow.id);Official SDKs
Python
pip install shadowphoneNode.js
npm install @shadowphone/sdkGo
go get shadowphone.com/sdk