Integration

The Integration section is where you connect NowRep to your portfolio website so you can push changes, preview content, and optionally enable live sync via webhooks. This section is only visible to Owners and Admins.

Site Connection

The Site Connection card configures the link between NowRep and your portfolio site.

Portfolio Site URL

Enter the base URL of your portfolio website (e.g., https://portfolio.youragency.com). This URL is used for:

• Push to Site — Sending updated data to your site
• Preview Latest — Opening a preview session on your site

Sync Secret

A secret token used to authenticate publish requests between NowRep and your portfolio site.

1. Click Generate to create a new sync secret (prefixed with nrsync_)
2. The secret is shown once — copy it immediately
3. Set it as the SYNC_SECRET environment variable on your portfolio site

Important: The sync secret is only displayed once when generated. If you lose it, you'll need to regenerate a new one, which invalidates the previous secret.

Test Connection

After configuring the URL and sync secret, click Test Connection to verify:

• Your portfolio site is reachable
• The sync secret is accepted

A success or failure message appears after the test.

Publishing to Your Site

Once connected, you can update your portfolio site in two ways:

Push to Site (Manual)

The Push to Site button in the publish bar sends all current data to your portfolio site in a single request. Use this for:

• Initial site setup
• After making a batch of changes
• When you want explicit control over what goes live

Live Sync (Automatic)

When webhooks are enabled (see below), every change to site-relevant data automatically notifies your portfolio site. The site then pulls the updated data on its own. The publish bar shows a green Live sync indicator when this is active.

Both methods can coexist — use live sync for day-to-day updates and the Push button as a manual override when needed.

Preview Mode

The Preview Latest button opens your portfolio site with a preview session. Here's how it works:

1. The first visit triggers a sync from NowRep to dedicated preview tables on the portfolio site
2. All navigation during the preview session reads from these preview tables — the live site data is unaffected
3. The session is maintained via a browser cookie (1-hour TTL), so the ?preview=true parameter is only needed on the first visit
4. An Exit Preview link in the preview banner clears the cookie and returns to the live site

Preview mode lets you review changes before pushing them live, and the preview URL can be shared with colleagues for review (the cookie is per-browser).

Webhook Notifications

The Webhook Notifications card configures optional outbound notifications that alert your portfolio site when data changes. This enables real-time sync without manual intervention.

Setting Up Webhooks

1. Toggle Enable to activate webhook notifications
2. Enter your Webhook URL — the HTTPS endpoint on your portfolio site (e.g., https://your-site.com/api/webhook)
3. Click Generate to create a Signing Secret (prefixed with nrwh_)
4. Copy the signing secret and configure it on your portfolio site for verification
5. Click Save

Test Webhook

Click Test Webhook to send a test.ping event to your endpoint. This verifies the URL is reachable and your site can process webhook payloads.

What Triggers Webhooks

Webhooks are sent only for changes to site-relevant data:

Internal-only changes (bookings, packages, directory contacts) do not trigger webhooks.

Webhook Security

Each webhook request includes two verification headers:

• X-NowRep-Signature — HMAC-SHA256 hex digest of the request body, signed with your signing secret
• X-NowRep-Event — The event name (e.g., talent.updated)

Your portfolio site should verify the signature on every request to ensure it came from NowRep and wasn't tampered with.

Delivery

• Webhooks are fire-and-forget — they do not retry on failure
• Each request has a 10-second timeout
• Failed deliveries are logged on the NowRep side but not surfaced in the UI

Tip: For maximum reliability, set up a periodic sync fallback (e.g., a cron job) on your portfolio site in addition to webhooks. This ensures your site stays up to date even if a webhook delivery fails.

Permissions

The Integration section requires the settings.manage permission, which limits access to Owners and Admins. Members and Viewers do not see this section in the Site navigation.

Related Pages

• Site Overview — Module overview and key concepts
• Publishing Content — Control what content appears on your site
• Branding — Customize your site's visual identity
• Roles & Permissions — Understanding access control