> ## Documentation Index > Fetch the complete documentation index at: https://docs.meetdarwin.ai/llms.txt > Use this file to discover all available pages before exploring further. # Make each person's own address for a link > Requires the `agent:read` scope. Up to 1,000 people per call, each with any of email, first_name, last_name, company and title, returned in order with their address and the greeting they will see. Nothing is stored: a person becomes a contact when they click. ## OpenAPI ````yaml /api-reference/openapi.json post /personal_links/{id}/urls openapi: 3.1.0 info: title: Darwin API version: '2026-10-12' description: >- Read and act on your Darwin workspace: conversations, contacts, meetings, outcome forms and their requests, personal links and their greetings, analytics, knowledge, the agent, its chat buttons and its opening tests, with signed webhooks for what happens. Authenticate with a secret key from Integrations → API: `Authorization: Bearer dk_live_…`. Keys carry scopes; personal data needs `contacts:read`. Rate limits are per key per minute: origin 120, adapt 120, evolve 600, apex 1200; heavy calls (exports, crawls, model work) have a smaller budget. Every response carries RateLimit-* headers. Lists are cursor-paginated (`limit`, `starting_after`, `next_cursor`). Writes accept `Idempotency-Key`. Errors are RFC 9457 problem documents with a stable `code` and a `request_id`. contact: name: Darwin url: https://docs.meetdarwin.ai/api-reference/introduction servers: - url: https://api.meetdarwin.ai/v1 security: - bearer: [] tags: - name: Workspace - name: Conversations - name: Contacts - name: Meetings - name: Outcomes - name: Personal links - name: Analytics - name: Events - name: Webhooks - name: Knowledge - name: Agent - name: Experiments - name: Privacy - name: Chat paths: /personal_links/{id}/urls: post: tags: - Personal links summary: Make each person's own address for a link description: >- Requires the `agent:read` scope. Up to 1,000 people per call, each with any of email, first_name, last_name, company and title, returned in order with their address and the greeting they will see. Nothing is stored: a person becomes a contact when they click. operationId: createPersonalUrls parameters: - name: id in: path required: true schema: type: string - name: Idempotency-Key in: header required: false description: >- Retry safely: the first response is replayed for 24 hours (not for streamed answers). schema: type: string maxLength: 255 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PersonalUrlsCreate' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PersonalUrlBatch' '400': description: Invalid request (`invalid_request`, `unsupported_version`). content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '401': description: >- Missing or invalid key (`authentication_required`, `invalid_api_key`). content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '402': description: >- The workspace must add a card before the API can be used (`payment_required`). content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '403': description: The key lacks the scope (`insufficient_scope`). content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '404': description: No such object in this workspace (`not_found`). content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '409': description: >- Conflicts with the current state (`conflict`, `idempotency_key_in_use`). content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '422': description: Refused by a rule (`unprocessable`, `idempotency_key_reused`). content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '429': description: >- Rate limited (`rate_limited`) or a monthly allowance used (`quota_exceeded`); see Retry-After. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' components: schemas: PersonalUrlsCreate: type: object properties: people: minItems: 1 maxItems: 1000 type: array items: type: object properties: email: anyOf: - type: string maxLength: 254 - type: 'null' first_name: anyOf: - type: string maxLength: 200 - type: 'null' last_name: anyOf: - type: string maxLength: 200 - type: 'null' company: anyOf: - type: string maxLength: 200 - type: 'null' title: anyOf: - type: string maxLength: 200 - type: 'null' external_id: description: >- Your own id for this person (a CRM record id), returned with their address. anyOf: - type: string maxLength: 200 - type: 'null' additionalProperties: false description: >- 1 to 1000 people, each with any of email, first_name, last_name, company and title. required: - people additionalProperties: false PersonalUrlBatch: type: object properties: object: type: string const: personal_url_batch link: type: string data: type: array items: type: object properties: object: type: string const: personal_url url: type: string external_id: type: - string - 'null' email: type: - string - 'null' greeting: type: string description: What the chat will say to this person. dropped: type: array items: type: string description: >- Details left out because the chat would not use them (an unfilled merge field, an invalid email). missing: type: array items: type: string description: >- Details the greeting uses that this person lacks; the greeting's fallback words are used. required: - object - url - external_id - email - greeting - dropped - missing required: - object - link - data Problem: type: object properties: type: type: string example: https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope title: type: string status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 code: type: string example: insufficient_scope detail: type: string param: type: string request_id: type: string example: req_8m2k4p0q1x7z9c3v5b6n required: - type - title - status - code - detail - request_id securitySchemes: bearer: type: http scheme: bearer description: >- A secret key (dk_live_…). Scopes: conversations:read, contacts:read, contacts:write, meetings:read, analytics:read, events:read, webhooks:write, knowledge:read, knowledge:write, agent:read, agent:write, experiments:read, experiments:write, privacy:write, chat:write. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.