Turn Typeform creator applications into vetted HubSpot contacts

Build an agent workflow that turns inbound creator partnership applications into enriched HubSpot contacts automatically.

Trigger: a Typeform webhook that fires when a creator submits my partnership-application form. The form collects four fields: full name, email, social handle, and platform (either Instagram or TikTok). Configure the trigger as an incoming webhook from Typeform so it runs the moment a response is submitted.

When the webhook fires, the agent should:

1. Read the handle and platform from the Typeform payload.

2. Pull a fresh HypeAuditor audit for that handle. If the platform is Instagram, call HypeAuditor's Get Instagram Report. If the platform is TikTok, call Get TikTok Report. Pin the request to the current report schema (v=2). Extract these signals from the report: follower count, engagement rate, audience authenticity score, top three audience countries with their share, dominant audience age bracket, and any brand-affinity or interest signals the report exposes. If HypeAuditor returns 202 Accepted, wait the retryTtl seconds and retry the same call. If the account is private, deleted, or not found, capture that failure mode so we can still file the contact with an explanation.

3. Write a two to three sentence creator fit summary in plain English. The summary should say whether this creator looks like a good brand fit and why, weighing audience quality, engagement, and audience geography against what we are looking for. Keep it short enough to read inside a HubSpot note preview.

4. Decide the lifecycle stage. Default the contact to qualified. Downgrade to needs human review when any of these are true: audience authenticity is below 60, the audience country mix or dominant age bracket materially disagrees with what the applicant claimed on the Typeform, or the HypeAuditor audit could not be completed (private, not found, or low-confidence report).

5. Upsert the contact into HubSpot using Batch Upsert Contacts keyed by email. Populate the standard contact properties (email, first name, last name) plus these custom properties: follower count, engagement rate, audience authenticity score, primary audience country, social platform, social handle, and a long-text creator fit summary. Set the lifecycle stage to either qualified or needs human review based on step 4.

Notes for the agent: HypeAuditor uses two custom headers (X-Auth-Id and X-Auth-Token) and charges one credit per report (refunded on private or restricted accounts). HubSpot's batch upsert accepts up to 100 contacts per call but this workflow only handles one application per run. The custom HubSpot properties (follower count, engagement rate, audience authenticity score, primary audience country, creator fit summary) must already exist on the contact object; if any are missing, surface a clear error instead of silently dropping the value.