Events and gated assets

Events and assets are two common lead magnets. Contacts register for an event through a public endpoint, and a server-to-server webhook (from Zoom, Google Meet, or Zapier) marks who attended. Gated assets, such as reports and guides, are downloaded through a link that can identify the contact who received it. Both score the contact and can enroll them in workflows.

Paths below use the default route prefixes. See public routes to change them.

Events#

Odden\Marketing\Models\MarketingEvent:

use Odden\Marketing\Models\MarketingEvent;

$event = MarketingEvent::create([
    'title' => 'Pipeline Masterclass',
    'event_type' => 'webinar',
    'starts_at' => now()->addWeek(),
    'virtual_meeting_url' => 'https://zoom.us/j/123',
    'capacity' => 500,
]);

$event->slug; // "pipeline-masterclass"

Helpers: attendanceRate(): float (attendees / registrations × 100, one decimal) and isFull(): bool (capacity set and reached). Relations: registrations and contacts (with status, registered_at, attended_at on the pivot).

The registration endpoint only accepts new registrations for events that are published (otherwise 404), have a status of scheduled or live (MarketingEvent::acceptsRegistrations()) and aren't full (isFull()). A closed or full event returns 409 with success: false and a message. A contact who is already registered can re-submit, even when the event is full or closed. The checks and the seat are taken inside RegisterContactForEventAction with the event row locked, so two people can't both take the last seat; it throws Odden\Marketing\Exceptions\EventRegistrationClosedException when a new registration is refused. A cancelled registration that registers again needs a seat like a new one. RegisterContactForEventAction::cancel($event, $contact) cancels a registration and frees its seat.

Registrations are Odden\Marketing\Models\MarketingEventRegistration rows: event_id, contact_id (unique together), status (registered, attended, no_show, cancelled by convention), registered_at, attended_at, and utm_source, utm_medium, utm_campaign.

Registration endpoint#

curl -X POST https://your-app.test/api/marketing/events/pipeline-masterclass/register \
  -H "Accept: application/json" -H "Content-Type: application/json" \
  -d '{"email": "ana@example.com", "first_name": "Ana", "utm_source": "newsletter"}'

{
    "success": true,
    "message": "Successfully registered for Pipeline Masterclass",
    "event": {
        "title": "Pipeline Masterclass",
        "starts_at": "2026-10-09T16:45:00+00:00",
        "virtual_meeting_url": "https://zoom.us/j/123"
    },
    "registration": {
        "id": 1,
        "status": "registered"
    }
}

The contact is matched by email ignoring case and surrounding whitespace (new contacts are stored lowercased), and created if missing, with first_name defaulting to Attendee. A placeholder Attendee name is replaced when a later registration includes a first name. An unknown slug returns 404.

Odden\Marketing\Actions\RegisterContactForEventAction then creates or updates the registration. You can call it directly:

use Odden\Marketing\Actions\RegisterContactForEventAction;

$registration = app(RegisterContactForEventAction::class)->execute(
    event: $event,
    contact: $contact,
    utm: ['utm_source' => 'partner'],
);

On the first registration of a contact for an event it increments registrations_count, logs a completed Registered for Event: {title} activity, and adds 10 points (property_match scoring event). Registering again resets the registration to registered with a new registered_at (an attended registration keeps its status and registered_at) and keeps earlier UTM values unless new ones are given, but doesn't score again.

Attendance webhook#

Send the token as described in API tokens.

curl -X POST https://your-app.test/api/marketing/events/pipeline-masterclass/attendance-webhook \
  -H "Authorization: Bearer $ODDEN_MARKETING_API_TOKEN" \
  -H "Accept: application/json" -H "Content-Type: application/json" \
  -d '{"email": "ana@example.com", "status": "attended"}'

{
    "success": true,
    "status": "attended",
    "attended_at": "2026-10-09T17:02:11+00:00"
}

status defaults to attended and must be one of registered, attended, no_show or cancelled (MarketingEventRegistration::STATUSES), otherwise the response is 422. The contact is looked up by email, ignoring case and surrounding whitespace. Errors:

Odden\Marketing\Actions\UpdateAttendanceStatusAction::execute(MarketingEventRegistration $registration, string $status) does the work and can be called directly. It recounts the event's attendees_count from registrations with status attended. When a registration becomes attended for the first time it also:

• sets attended_at;
• logs a completed Attended Event: {title} activity;
• adds 20 points (property_match);
• enrolls the contact in active event_attended workflows whose trigger_config.event_id is this event or unset.

Gated assets#

Odden\Marketing\Models\MarketingAsset represents a downloadable file or link:

use Odden\Marketing\Models\MarketingAsset;

$asset = MarketingAsset::create([
    'name' => 'State of RevOps 2026',
    'asset_type' => 'report',
    'external_url' => 'https://cdn.example.com/state-of-revops-2026.pdf',
    'lead_score_points' => 25,
]);

Relations: downloads (MarketingAssetDownload rows) and downloadingContacts.

Signed download links#

getDownloadUrl(?Contact $contact = null): string builds the link. With a contact, it adds contact_id and a signature, an HMAC-SHA256 of the asset id and contact id keyed with app.key:

$url = $asset->getDownloadUrl($contact);
// https://your-app.test/marketing/assets/state-of-revops-2026/download?contact_id=17&signature=9b1e...

Put this link in the email that delivers the asset (for example after a form submission) so the download is attributed to the contact. Links don't expire. A bare contact_id never identifies anyone. resolveSignedContact(mixed $contactId, mixed $signature): ?Contact checks a signature yourself.

A gated asset (is_gated, the default) is only served through a signed link; any other request gets 403. An ungated asset also downloads from a bare link, unattributed. An inactive asset (is_active false) returns 404. The route never asks for a form itself: the gate is the form (or other step) after which you send the signed link. If the asset has neither external_url nor an existing file_path, the route redirects back with a success flash message and nothing is downloaded.

Download tracking#

Every request to the download route runs Odden\Marketing\Actions\TrackAssetDownloadAction, which:

• stores a MarketingAssetDownload (contact_id, ip_address, user_agent, a random download_token, downloaded_at);
• increments downloads_count, and unique_leads_count on a contact's first download.

For an identified contact it also:

• logs a completed Downloaded Asset: {name} activity;
• adds lead_score_points (property_match, skipped when 0), on every download;
• enrolls the contact in active asset_downloaded workflows whose trigger_config.asset_id is this asset or unset.

To record a download from your own code:

use Odden\Marketing\Actions\TrackAssetDownloadAction;

$download = app(TrackAssetDownloadAction::class)->execute(asset: $asset, contact: $contact);

The full signature is execute(MarketingAsset $asset, ?Contact $contact = null, ?string $ipAddress = null, ?string $userAgent = null): MarketingAssetDownload.