Aimfox webhook guide
When to use this guide: Use this guide when configuring Aimfox with OutboundSync — creating the webhook receiver, choosing events, and mapping social profile lookup fields.
OutboundSync receives Aimfox workspace webhooks and writes social outreach activity to the matching contact or lead in HubSpot or Salesforce. Aimfox sends many event types with overlapping names; this guide shows a practical selection so you sync the activity you care about without obvious duplicate replies.
Before you start
Section titled “Before you start”- An OutboundSync account — create your account if needed.
- HubSpot or Salesforce connected — HubSpot setup guide or Salesforce setup guide.
- Access to the Aimfox workspace Settings → Webhooks tab (Aimfox webhook help).
Aimfox does not require an OutboundSync API key for activity sync. The webhook URL alone delivers events. CRM-driven block list sync is not available for Aimfox yet.
Create the Aimfox webhook receiver in OutboundSync
Section titled “Create the Aimfox webhook receiver in OutboundSync”- Sign in at app.outboundsync.com.
- Open Webhooks and create a new webhook receiver.
- Choose Aimfox as the platform and select your connected CRM (HubSpot or Salesforce).
- Configure receiver settings as you would for other social platforms:
- Webhook owner — Salesforce or HubSpot user who owns newly created records. See Identifying OutboundSync activity in Salesforce when auditing Created By vs Owner.
- Activity object (Salesforce) — most teams use Tasks for per-event reporting granularity.
- Contact / lead lookup — map the social profile URL field OutboundSync should match on (standard social/LinkedIn URL field or a custom property). Aimfox payloads include the prospect profile URL; matching behavior for varied URL formats is the same approach documented for other social SEPs in Handling social profile URLs for matching.
- Save the receiver and copy the webhook URL OutboundSync generates.
If CRM field or permission pickers are empty, or you see a session-expired error while saving, sign out of OutboundSync, sign back in, and reopen the webhook form so Salesforce session data reloads.
Add the webhook in Aimfox
Section titled “Add the webhook in Aimfox”- In Aimfox, open Workspace settings → Webhooks.
- Click Add webhook.
- Enter a clear Name (for example
OutboundSync — production). - Paste the OutboundSync webhook URL into URL.
- Leave Authentication Header blank unless your team has a custom requirement — OutboundSync receivers authenticate via the unique URL.
- Select events using the guidance below, then Save.
Aimfox applies webhooks at the workspace level. One OutboundSync receiver URL is enough for that workspace’s campaign activity.
Which Aimfox events to enable
Section titled “Which Aimfox events to enable”OutboundSync processes Aimfox social activity for connections, messages, premium messages, replies, profile views, and labels. Aimfox’s UI lists several connection, reply, and inbox events that sound alike — pick one clear path for each instead of enabling every overlapping option.
Recommended core events
Section titled “Recommended core events”Enable these for a typical OutboundSync setup:
| Aimfox event (UI label) | Why enable it |
|---|---|
| Connect Sent | Connection requests your campaigns send |
| Connect Request Accepted | Acceptances that establish a new connection |
| Message Sent | Standard messages sent to prospects |
| Message Request Sent | Message requests when that channel is in use |
| Inmail Sent | Premium message sends |
| New Reply | Replies across conversations (not only the first reply) |
| Inmail Reply | Premium message replies when you send premium messages |
| Lead Label Added | Labels / categories your team applies in Aimfox |
| Lead Viewed | Profile views, when you want that activity in CRM |
Overlapping connection events (avoid doubles)
Section titled “Overlapping connection events (avoid doubles)”Aimfox exposes more than one acceptance-related trigger. Enabling both for the same acceptance can create duplicate CRM activities.
| Event | Behavior | Recommendation |
|---|---|---|
| Connect Request Accepted | Connection acceptance from your outreach | Prefer this for acceptance sync |
| New Connection | New connection established (often overlaps with acceptance) | Skip when Connect Request Accepted is enabled |
Overlapping reply and inbox events (avoid doubles)
Section titled “Overlapping reply and inbox events (avoid doubles)”Aimfox exposes multiple reply-related triggers. Enabling several of them for the same conversations can create duplicate CRM activities.
| Event | Behavior | Recommendation |
|---|---|---|
| New Reply | Catches replies broadly (not limited to the first reply) | Prefer this for reply sync |
| Message Reply | First reply only for a lead / conversation start | Skip when New Reply is enabled |
| Campaign Reply | Reply in an Aimfox campaign context | Skip when New Reply (or inbox campaign reply) already covers it |
| Inbox Event | Broad inbox activity (sends and receives; type field distinguishes direction) | Optional catch-all. If you enable it and discrete Message Sent / New Reply events, watch for duplicates after go-live and trim if the same touch lands twice |
Practical rule: start with the recommended core table. Add Inbox Event only if you need a broader catch-all and are willing to review logs for duplicates. If live campaigns show the same reply twice in Salesforce or HubSpot, remove the overlapping reply/inbox options and keep New Reply (plus Inmail Reply when you use premium messages).
Skip — not synced by OutboundSync today
Section titled “Skip — not synced by OutboundSync today”These Aimfox events do not create CRM activities in OutboundSync, even if you enable them in Aimfox:
- Campaign Created
- Campaign Started
- Campaign Ended
- Account Connected
- Account Disconnected
Verify the connection
Section titled “Verify the connection”- In OutboundSync, open the Aimfox webhook receiver and use Sending test webhook payloads to push a sample event.
- Confirm the test lands on the expected contact or lead, with the social profile match you configured.
- After live Aimfox campaigns start, check OutboundSync logs if expected activity is missing or duplicated.
Limitations and considerations
Section titled “Limitations and considerations”- One webhook URL per OutboundSync receiver. Do not reuse the same OutboundSync URL for unrelated Aimfox experiments if you need separate CRM routing.
- No Aimfox API key required for webhook activity sync.
- No CRM → Aimfox block list sync in OutboundSync today. Maintain Aimfox blacklists in Aimfox until product support lands.
- Event taxonomy may evolve. Aimfox can rename or add overlapping UI labels. If a label in your workspace differs slightly from this table, match on the description Aimfox shows next to the event (first reply vs every reply, inbox vs campaign).
Next steps
Section titled “Next steps”- Aimfox overview — scope, CRM destinations, and limitations
- How category-based filters work — gate which activities write to the CRM
- How teammates get OutboundSync account access — add coworkers after Salesforce or HubSpot is connected
