> ## Documentation Index
> Fetch the complete documentation index at: https://docs.letterdrop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add target accounts

> Add companies by domain, company page URL, or both (the page is the more precise match). An account already in the workspace is updated, not duplicated. Accounts with only a domain are matched to their company page in the background when job-change tracking or Find contacts is on.



## OpenAPI

````yaml /openapi.json post /target-accounts
openapi: 3.1.0
info:
  title: Letterdrop Competitor Signals API
  version: 2.0.0
  license:
    name: Proprietary
    url: https://letterdrop.com/terms
  description: >-
    Read your workspace's Competitor Signals data: the accounts showing
    competitor signals, the contacts and signals behind each, their CRM context,
    your outreach, and the dashboard metrics.


    It also manages your target accounts and returns the people who recently
    changed jobs into them (Target accounts), and reads the workspace's buyer
    filters and tracked competitors.


    The API speaks the same language as the New Competitor Deal webhook (payload
    version v2): a field has the same name and the same values in both, so
    whatever you build on one reads the other.


    **Versioning.** The major version is in the path (/api/v2). Within v2
    changes are additive only (new optional fields, filters, endpoints), so
    ignore fields you do not recognise. The v1 Competitor Signals endpoints keep
    working unchanged.


    **Rate limits.** Per workspace: 10 requests/second and 600/minute, plus 20
    uncached computations/minute (analytics count as 4). Cached reads
    (meta.cache = hit), including every later page of a list you already
    started, use no computation budget. Every response carries RateLimit-Limit /
    RateLimit-Remaining / RateLimit-Reset; a 429 carries Retry-After.


    **Freshness.** Results are cached for a few minutes (analytics and filter
    options a little longer); meta.data_as_of says when the data was computed.
    Signals are collected daily, so polling faster than every few minutes
    returns the same data.
servers:
  - url: https://api.letterdrop.com/api/v2
security: []
tags:
  - name: Accounts
    description: Companies with competitor signals, and what we know about each.
  - name: Contacts
    description: The people behind the signals.
  - name: Analytics
    description: The dashboard metrics, one endpoint each.
  - name: Filters
    description: Every key of every object, and how to select and filter on it.
  - name: Target accounts
    description: >-
      The companies you sell to, and the people who just joined them. Writes
      need the mcp.write scope (any API key has it).
  - name: Buyer filters
    description: The companies and people you sell to.
  - name: Tracked competitors
    description: >-
      The competitors you track, and the exec and company pages monitored for
      each.
paths:
  /target-accounts:
    post:
      tags:
        - Target accounts
      summary: Add target accounts
      description: >-
        Add companies by domain, company page URL, or both (the page is the more
        precise match). An account already in the workspace is updated, not
        duplicated. Accounts with only a domain are matched to their company
        page in the background when job-change tracking or Find contacts is on.
      operationId: addTargetAccounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                accounts:
                  minItems: 1
                  maxItems: 1000
                  type: array
                  items:
                    type: object
                    properties:
                      company_domain:
                        description: The company's website domain, e.g. acme.com.
                        type: string
                        maxLength: 255
                      company_linkedin_url:
                        type: string
                        maxLength: 500
                        description: >-
                          The company's page URL on the professional network
                          (…/company/<name>).
                      company_name:
                        description: Company name. Optional.
                        type: string
                        maxLength: 200
                    additionalProperties: false
                  description: >-
                    Up to 1000 accounts. Each needs company_domain or
                    company_linkedin_url; an account already in the workspace
                    (same page, or same domain when there is no page) is
                    updated, not duplicated.
              required:
                - accounts
              additionalProperties: false
            example:
              accounts:
                - company_domain: acme.com
                  company_linkedin_url: https://example.com/company/acme
                - company_domain: globex.com
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data:
                    $ref: '#/components/schemas/TargetAccountsAdded'
                  meta:
                    $ref: '#/components/schemas/Meta'
              example:
                data:
                  added: 2
                  rejected: []
                  target_accounts:
                    - id: 6a1f0c2e9b1d4c0012ab34cd
                      company_name: Acme
                      company_domain: acme.com
                      company_linkedin_url: https://example.com/company/acme
                      source: upload
                      created_at: '2026-11-02T09:36:28.016Z'
                    - id: 6a1f0c2e9b1d4c0012ab34ce
                      company_name: globex.com
                      company_domain: globex.com
                      company_linkedin_url: ''
                      source: upload
                      created_at: '2026-11-02T09:36:28.016Z'
                meta:
                  api_version: '2'
                  data_as_of: '2026-11-02T09:36:28.016Z'
                  cache: 'off'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/Unprocessable'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/ServerError'
      security:
        - WorkspaceKey: []
        - BearerAuth:
            - mcp.write
components:
  schemas:
    TargetAccountsAdded:
      type: object
      description: Result of adding target accounts.
      properties:
        added:
          type: integer
          description: Accounts accepted (new or updated).
        rejected:
          type: array
          description: Accounts refused, by their position in the request.
          items:
            type: object
            properties:
              index:
                type: integer
              error:
                type: string
        target_accounts:
          type: array
          items:
            $ref: '#/components/schemas/TargetAccount'
          description: The accepted accounts as stored.
    Meta:
      type: object
      required:
        - api_version
        - data_as_of
        - cache
      properties:
        api_version:
          type: string
          const: '2'
        data_as_of:
          type: string
          format: date-time
          description: >-
            When the data in this response was computed. Responses are cached
            for a few minutes; this tells you how fresh they are.
        cache:
          type: string
          enum:
            - hit
            - miss
            - shared
            - 'off'
          description: >-
            hit = served from cache; miss = computed for this request; shared =
            joined a computation already running for the same query.
    TargetAccount:
      type: object
      description: A company on the workspace's Target Accounts page.
      properties:
        id:
          type: string
          description: Target account id. Use it to remove the account.
        company_name:
          type: string
          description: Company name (the domain, until enrichment finds the name).
        company_domain:
          type: string
          description: Website domain.
        company_linkedin_url:
          type: string
          description: The company's page URL. Empty until matched.
        source:
          type: string
          description: 'Where it came from: upload (CSV or API), hubspot or salesforce.'
          x-values:
            - upload
            - hubspot
            - salesforce
        created_at:
          type:
            - string
            - 'null'
          format: date-time
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              enum:
                - invalid_request
                - invalid_json
                - invalid_cursor
                - cursor_expired
                - unauthorized
                - forbidden
                - account_not_found
                - not_found
                - rate_limited
                - internal_error
            message:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  path:
                    type: string
                  message:
                    type: string
              description: 'For invalid_request: one entry per parameter that failed.'
  responses:
    Unauthorized:
      description: Missing or invalid credential.
      x-status: 401
      x-codes:
        - unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: >-
        The credential lacks the scope the operation needs (mcp.read to read,
        mcp.write to write).
      x-status: 403
      x-codes:
        - forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unprocessable:
      description: A parameter failed validation; details lists each one.
      x-status: 422
      x-codes:
        - invalid_request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    TooManyRequests:
      description: Rate limited; wait Retry-After seconds.
      x-status: 429
      x-codes:
        - rate_limited
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      headers:
        Retry-After:
          schema:
            type: integer
          description: Seconds to wait.
    ServerError:
      description: Our fault; retry, and contact support if it persists.
      x-status: 500
      x-codes:
        - internal_error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    WorkspaceKey:
      type: apiKey
      in: header
      name: api-key
    BearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.