Agents

Submit contact details for a real estate agent

postapi.modelmatch.com/v1/agents/contact-submissions

Send contact details you know for a real estate agent — a phone number, an email address, a profile link, or the company they moved to. The submission is checked and reviewed before anything appears on the profile; this call only records it and answers immediately. Sending the same details for the same person again while the first submission is still being reviewed returns the first submission's id.

Authorization

x-api-keystringrequired

API key or OAuth token. See Authentication.

Body application/json

entityIdstringrequired

The agent's id (a previous id for the same agent is accepted).

itemsone of[]required

The contact details being submitted, 1 to 10, each value once. At most one company.

Show child attributes

Option 1object

Show child attributes

kindenumrequired

Options:phone

labelenum

Options:mobileofficedirect

valuestringrequired

A US phone number in E.164 form: +1 followed by exactly 10 digits.

Option 2object

Show child attributes

kindenumrequired

Options:email

labelenum

Options:workpersonal

valuestringrequired

Option 3object

Show child attributes

kindenumrequired

Options:profile

valuestringrequired

Absolute http(s) URL of the person's profile page, on a public website.

Option 4object

Show child attributes

kindenumrequired

Options:company

valuestringrequired

Name of the company the person now works at.

notestring

Where the details came from, in the submitter's words (up to 1000 characters). May include a link. Markup and control characters are removed.

Responses

202objectRecorded. Review happens afterwards.

Show attributes

dataobjectrequired

Show child attributes

idstringrequired

The submission id.

400objectValidation error

401objectUnauthorized

403objectForbidden (authenticated, but missing required context — e.g. no active organization)

404objectNot found

413objectThe request body is too large.

415objectThe body must be sent as `application/json`.

429objectToo many submissions in the last 24 hours. Try again later.

503objectSearch timed out or the cluster is overloaded — retry after `Retry-After` seconds.

curl -X POST "https://api.modelmatch.com/v1/agents/contact-submissions" \
  -H "x-api-key: $MODEL_MATCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityId": "mma_123456",
    "items": [
      {
        "kind": "phone",
        "value": "+19497422474"
      }
    ],
    "note": "Listed on her new company bio page"
  }'

import { createClient } from "@model-match/api";

const client = createClient({ apiKey: process.env.MODEL_MATCH_API_KEY });

const { data, error } = await client.agents.createAgentContactSubmission({
  body: {
    entityId: "mma_123456",
    items: [
      {
        kind: "phone",
        value: "+19497422474"
      }
    ],
    note: "Listed on her new company bio page"
  }
});

import os
import requests

res = requests.post(
    "https://api.modelmatch.com/v1/agents/contact-submissions",
    headers={"x-api-key": os.environ["MODEL_MATCH_API_KEY"]},
    json={
        "entityId": "mma_123456",
        "items": [
            {
                "kind": "phone",
                "value": "+19497422474"
            }
        ],
        "note": "Listed on her new company bio page"
    },
)
data = res.json()

202 response

{
  "data": {
    "id": "<string>"
  }
}