curl -X DELETE "https://api.hooked.so/v1/integration/cm3c4d5e6f7g8h9i0j1k2l3m4" \
-H "x-api-key: your_api_key_here"
const integrationId = 'cm3c4d5e6f7g8h9i0j1k2l3m4';
const response = await fetch(`https://api.hooked.so/v1/integration/${integrationId}`, {
method: 'DELETE',
headers: { 'x-api-key': process.env.HOOKED_API_KEY }
});
const result = await response.json();
console.log(result.data.deleted);
import requests
integration_id = 'cm3c4d5e6f7g8h9i0j1k2l3m4'
response = requests.delete(
f'https://api.hooked.so/v1/integration/{integration_id}',
headers={'x-api-key': 'your_api_key_here'}
)
print(response.json()['message'])
{
"success": true,
"message": "Integration disconnected successfully",
"data": {
"id": "cm3c4d5e6f7g8h9i0j1k2l3m4",
"type": "youtube",
"deleted": true
}
}
{
"code": "not_found",
"message": "Integration not found",
"errorCode": "RESOURCE_NOT_FOUND",
"details": {
"resource_id": "cm3c4d5e6f7g8h9i0j1k2l3m4",
"resource_type": "Integration"
}
}
Channels
Disconnect Integration
Remove a connected social account from your team
DELETE
/
v1
/
integration
/
{integrationId}
curl -X DELETE "https://api.hooked.so/v1/integration/cm3c4d5e6f7g8h9i0j1k2l3m4" \
-H "x-api-key: your_api_key_here"
const integrationId = 'cm3c4d5e6f7g8h9i0j1k2l3m4';
const response = await fetch(`https://api.hooked.so/v1/integration/${integrationId}`, {
method: 'DELETE',
headers: { 'x-api-key': process.env.HOOKED_API_KEY }
});
const result = await response.json();
console.log(result.data.deleted);
import requests
integration_id = 'cm3c4d5e6f7g8h9i0j1k2l3m4'
response = requests.delete(
f'https://api.hooked.so/v1/integration/{integration_id}',
headers={'x-api-key': 'your_api_key_here'}
)
print(response.json()['message'])
{
"success": true,
"message": "Integration disconnected successfully",
"data": {
"id": "cm3c4d5e6f7g8h9i0j1k2l3m4",
"type": "youtube",
"deleted": true
}
}
{
"code": "not_found",
"message": "Integration not found",
"errorCode": "RESOURCE_NOT_FOUND",
"details": {
"resource_id": "cm3c4d5e6f7g8h9i0j1k2l3m4",
"resource_type": "Integration"
}
}
Overview
Deletes the connection to a social account. Videos already published stay on the platform.Disconnecting also deletes, in Hooked, every post recorded for that integration: published history and pending scheduled posts alike. If you want to keep track of what was scheduled, read it with List Scheduled Posts first. This cannot be undone.
id; update any id you stored.
curl -X DELETE "https://api.hooked.so/v1/integration/cm3c4d5e6f7g8h9i0j1k2l3m4" \
-H "x-api-key: your_api_key_here"
const integrationId = 'cm3c4d5e6f7g8h9i0j1k2l3m4';
const response = await fetch(`https://api.hooked.so/v1/integration/${integrationId}`, {
method: 'DELETE',
headers: { 'x-api-key': process.env.HOOKED_API_KEY }
});
const result = await response.json();
console.log(result.data.deleted);
import requests
integration_id = 'cm3c4d5e6f7g8h9i0j1k2l3m4'
response = requests.delete(
f'https://api.hooked.so/v1/integration/{integration_id}',
headers={'x-api-key': 'your_api_key_here'}
)
print(response.json()['message'])
{
"success": true,
"message": "Integration disconnected successfully",
"data": {
"id": "cm3c4d5e6f7g8h9i0j1k2l3m4",
"type": "youtube",
"deleted": true
}
}
{
"code": "not_found",
"message": "Integration not found",
"errorCode": "RESOURCE_NOT_FOUND",
"details": {
"resource_id": "cm3c4d5e6f7g8h9i0j1k2l3m4",
"resource_type": "Integration"
}
}
Errors
| Status | When |
|---|---|
| 401 | Missing or invalid API key (code: "not_authenticated") |
| 403 | Your team does not have the Hooked app product (code: "entitlement_required") |
| 404 | No integration with that id, including one already disconnected (code: "not_found"). An id that belongs to another team answers the same way |
| 500 | { "success": false, "message": "Failed to disconnect integration", "error": "..." } |
Next Steps
List Integrations
See the accounts still connected
List Scheduled Posts
Review scheduled posts