Customer Listings Integration

Last updated: February 6, 2026
Admin Tools

Customer Listings Integration

Creating Listings with Contact Auto-Copy

Location: `/admin/listings/create`

Workflow

  1. Select Customer

    • Use CustomerSelector dropdown
    • Search by company name or contact name
    • Click "➕ Add New Customer" if needed
  2. Select Contact

    • CustomerContactSelector enabled after customer selected
    • Search/select from customer's contacts
    • Click "➕ Add Contact" if customer contact doesn't exist
  3. Fill Listing Details

    • Title, description, salary, location, etc.
  4. Submit

    • Backend automatically copies selected contact data to ListingContact
    • Listing + ListingContact created in single transaction

Backend Automation

Endpoint: `POST /api/v1/admin/listings`

Optional DTO Field: `customerContactId?: string`

Behavior:

  • Validates customerContactId exists and belongs to customer
  • Creates Listing record
  • Creates ListingContact record with copied data (name, email, phone)
  • Both created in atomic Prisma transaction

Benefits

  • Reusable contacts across multiple listings
  • No duplicate data entry
  • Contact changes don't affect existing listings (isolation)
  • Faster listing creation workflow

Was this article helpful?

Your feedback helps us improve our support content.

Still need assistance?

Our support team is ready to help you with more complex issues.

Contact Support