interviews

Start Interview

Launch a campaign: validate, mark active, and send or schedule invitations.

Invitations go out on the campaign's channel: in_app_chat emails each contact a personal interview link, slack sends a Slack DM (email fallback), teams sends a Microsoft Teams chat message (email fallback). Participants self-schedule. Legacy google_meet campaigns still create Google Calendar events with Meet links.

Campaigns with start_immediately=false and a future timeframe_start do NOT send invitations at launch — a job sends them when the campaign opens (date-only starts resolve to 08:00 in the campaign's timezone). timeframe_end is a soft response deadline shown to participants; it never blocks late responses.

Validation (goal length, at least one contact, at least one question, Slack connection + reachable contacts for Slack campaigns) runs first; on failure the campaign stays in draft.

post/v1/interviews/{interview_id}/start

Path parameters

interview_idstring uuid required

Headers

X-API-Keystring nullable

Response

Successful Response

scheduled_countinteger required
messagestring required

Changes

No recorded changes to this endpoint across all 1 revision of this API.