Skip to main content
GET
cURL
Contacts power Feedspace’s email automation. They are commonly synced from external platforms (Zapier, Pabbly, Make, n8n) using your API key.
Contact endpoints require the workspace’s plan and role to include email automation. If the account does not have it, these endpoints return 403.

Authorizations

Authorization
string
header
required

HTTP Basic Authentication using API Key and Secret Key. The credentials should be Base64 encoded in the format 'api_key:secret_key'. You can obtain your API Key and Secret Key from Feedspace → Automation → API (https://app.feedspace.io/automation/api).

Query Parameters

source
enum<string>

Filter by how the contact first entered the workspace. One of: csv, public_api, review_submission, manual, social_import, stripe.

Available options:
csv,
public_api,
review_submission,
manual,
social_import,
stripe
tag_ids[]
integer[]

Filter to contacts carrying any of these tag IDs. Each value must be a numeric tag id from GET /contact-tags in this workspace.

unsubscribed
enum<string>
default:all

Subscription state to include.

Available options:
subscribed,
unsubscribed,
all
q
string

Free-text search across name and email (max 255 characters).

Maximum string length: 255
sort_by
enum<string>
default:created_at

Sort field.

Available options:
created_at,
email,
name
sort_dir
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc
page
integer
default:1

Page number (default 1).

Required range: x >= 1
per_page
integer
default:50

Items per page (1-100, default 50).

Required range: 1 <= x <= 100

Response

200 - application/json

Contacts fetched successfully.

data
object[]
meta
object

Pagination metadata: current_page, last_page, per_page, total, from, to, and has_activated_automation.