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

# Update a sending account

> Changes an account's settings and answers it. A mailbox takes `name`, `dailyCapacity` and `signature`; a seat takes `dailyLimits`, `weeklyLimits` and `signature`, held to what the seat allows (`422` `linkedin_daily_limits_exceeded`). A field the account's channel does not take answers `422` `validation_failed`.

Free. **Scope:** connections, with a key that can write.



## OpenAPI

````yaml /openapi.json patch /v1/accounts/{channel}/{accountId}
openapi: 3.1.0
info:
  title: outbound.dev API
  version: v1
  description: Find people and companies, and see what every call costs, with one API key.
servers:
  - url: https://api.outbound.dev
security: []
tags:
  - name: People
    description: >-
      Search people with filters, a saved search or a plain-language query,
      count matches and look up filter values.
  - name: Companies
    description: >-
      Search companies, count matches, name one company by its name, domain or
      LinkedIn page, and list its people.
  - name: Saved searches
    description: Keep a search under a title and run it again, for people or for companies.
  - name: Lists
    description: >-
      Keep people or companies in lists: create and change lists, page through
      their rows, and add or remove people.
  - name: Folders
    description: Group lists of one kind into folders.
  - name: Enrichment
    description: >-
      Find people's work emails and phone numbers: one person, a batch of
      people, or a list.
  - name: Jobs
    description: >-
      Long tasks a call started: their progress, what they produced and what
      they were charged, and stopping them.
  - name: Accounts
    description: >-
      Connect the mailboxes and LinkedIn seats that campaigns and the inbox send
      from, and look after them.
  - name: Campaigns
    description: >-
      Email and LinkedIn campaigns: their steps, the people they enroll, their
      queue of messages, templates, the knowledge hubs and writing styles AI
      steps are written from, the tracking domain their links go through, and
      the lists every campaign leaves out.
  - name: Inbox
    description: >-
      Read and answer the conversations of your mailboxes and LinkedIn seats,
      and send new messages and invitations.
  - name: Account
    description: >-
      The calling key and its organization, its rate limits, and revoking the
      key.
  - name: Billing
    description: The balance, the ledger of every change to it, and the price list.
  - name: Usage and requests
    description: >-
      Calls and spend by day, and the record of every request of the last 30
      days.
paths:
  /v1/accounts/{channel}/{accountId}:
    patch:
      tags:
        - Accounts
      summary: Update a sending account
      description: >-
        Changes an account's settings and answers it. A mailbox takes `name`,
        `dailyCapacity` and `signature`; a seat takes `dailyLimits`,
        `weeklyLimits` and `signature`, held to what the seat allows (`422`
        `linkedin_daily_limits_exceeded`). A field the account's channel does
        not take answers `422` `validation_failed`.


        Free. **Scope:** connections, with a key that can write.
      operationId: patchAccountsChannelAccountId
      parameters:
        - name: channel
          in: path
          required: true
          description: '`email` for a mailbox, `linkedin` for a LinkedIn seat.'
          schema:
            type: string
            enum:
              - email
              - linkedin
        - name: accountId
          in: path
          required: true
          description: >-
            The account's `id` from `GET /v1/accounts`: a mailbox's address (any
            case, `@` as is or as `%40`) or a seat's id.
          schema:
            type: string
            minLength: 1
            maxLength: 320
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: >-
                    Mailboxes: the sender name recipients see. A seat's name is
                    its LinkedIn profile's.
                  maxLength: 200
                dailyCapacity:
                  type: integer
                  description: >-
                    Mailboxes: the most emails it sends a day, 1 to 15. Start a
                    mailbox under 3 months old at 5.
                  minimum: 1
                  maximum: 15
                dailyLimits:
                  type: object
                  description: >-
                    Seats: `invitations` and `messages` a day, together. Free
                    seats allow up to 20 and 80, premium seats up to 80 and 150.
                  properties:
                    invitations:
                      type: integer
                      minimum: 0
                      maximum: 10000
                    messages:
                      type: integer
                      minimum: 0
                      maximum: 10000
                  required:
                    - invitations
                    - messages
                weeklyLimits:
                  type: object
                  description: >-
                    Seats: `invitations` and `messages` a week, together. Free
                    seats allow up to 100 and 400, premium seats up to 200 and
                    800.
                  properties:
                    invitations:
                      type: integer
                      minimum: 0
                      maximum: 10000
                    messages:
                      type: integer
                      minimum: 0
                      maximum: 10000
                  required:
                    - invitations
                    - messages
                signature:
                  type: string
                  description: >-
                    What `{Sender Signature}` inserts: HTML on a mailbox, up to
                    10,000 characters; plain text on a seat, up to 2,000. Empty
                    removes it.
                  maxLength: 10000
            example:
              name: Maya Fern
              dailyCapacity: 10
      responses:
        '200':
          description: The account.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Charged-Usd:
              $ref: '#/components/headers/ChargedUsd'
            X-Balance-Usd:
              $ref: '#/components/headers/BalanceUsd'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
          content:
            application/json:
              schema:
                type: object
                description: >-
                  A mailbox (`channel` `email`) or a LinkedIn seat (`channel`
                  `linkedin`). A field without a value is absent.
                required:
                  - channel
                  - id
                  - isActive
                  - isConnected
                properties:
                  channel:
                    type: string
                    enum:
                      - email
                      - linkedin
                  id:
                    type: string
                    description: A mailbox's email address, or a seat's id.
                  name:
                    type: string
                    description: >-
                      A mailbox's sender name, or the seat's LinkedIn profile
                      name.
                  isActive:
                    type: boolean
                    description: Campaigns may send from it.
                  isConnected:
                    type: boolean
                    description: Its sign-in works.
                  emailAddress:
                    type: string
                    description: Mailboxes.
                  provider:
                    type: string
                    description: 'Mailboxes: `smtp`, `gmail` or `outlook`.'
                  dailyCapacity:
                    type: integer
                    description: 'Mailboxes: the most emails it sends a day.'
                  availableCapacity:
                    type: integer
                    description: 'Mailboxes: what is left of it today.'
                  needsReauthAt:
                    type: string
                    format: date-time
                    description: 'Mailboxes: when its sign-in stopped working.'
                  needsReauthReason:
                    type: string
                    description: 'Mailboxes: why, such as `smtp_auth_rejected`.'
                  warmup:
                    type: object
                    description: 'Mailboxes: its warmup.'
                    properties:
                      status:
                        type: string
                        enum:
                          - new
                          - warming
                          - warmed
                          - paused
                          - issue
                      startedAt:
                        type: string
                        format: date-time
                      daysActive:
                        type: integer
                      last7Days:
                        type: object
                        description: >-
                          Warmup emails sent in the last 7 days, and where they
                          landed.
                        properties:
                          sent:
                            type: integer
                          inbox:
                            type: integer
                          spam:
                            type: integer
                      dnsGrade:
                        type: string
                        description: The domain's mail setup, A to F.
                  email:
                    type: string
                    description: 'Seats: the LinkedIn sign-in email.'
                  publicIdentifier:
                    type: string
                    description: >-
                      Seats: the profile's address name, as in
                      linkedin.com/in/...
                  type:
                    type: string
                    description: 'Seats: `classic`, `sales_navigator` or `recruiter`.'
                  status:
                    type: string
                    description: >-
                      Seats, one at a time: `connected`, `reconnected` or
                      `disconnected`.
                  dailyLimits:
                    type: object
                    properties:
                      invitations:
                        type: integer
                      messages:
                        type: integer
                    description: 'Seats, one at a time: invitations and messages a day.'
                  dailyRemaining:
                    type: object
                    properties:
                      invitations:
                        type: integer
                      messages:
                        type: integer
                    description: 'Seats, one at a time: what is left today.'
                  weeklyLimits:
                    type: object
                    properties:
                      invitations:
                        type: integer
                      messages:
                        type: integer
                    description: 'Seats, one at a time: invitations and messages a week.'
                  weeklyRemaining:
                    type: object
                    properties:
                      invitations:
                        type: integer
                      messages:
                        type: integer
                    description: >-
                      Seats, one at a time: what is left this week (from Monday,
                      UTC).
                  signature:
                    type: string
                    description: 'One at a time: the signature `{Sender Signature}` inserts.'
              example:
                channel: linkedin
                id: sBzWb1QeTTqF0vUpHKa2xg
                name: Maya Fern
                publicIdentifier: maya-fern
                type: classic
                isActive: true
                isConnected: true
                status: connected
                dailyLimits:
                  invitations: 20
                  messages: 80
                dailyRemaining:
                  invitations: 18
                  messages: 80
                weeklyLimits:
                  invitations: 100
                  messages: 400
                weeklyRemaining:
                  invitations: 91
                  messages: 372
        '429':
          $ref: '#/components/responses/RateLimited'
        4XX:
          $ref: '#/components/responses/Error'
        5XX:
          $ref: '#/components/responses/ServerError'
      security:
        - apiKey: []
components:
  headers:
    RequestId:
      description: The request's id. Quote it when you write to support.
      schema:
        type: string
        example: req_6a1f0c2b9d4e8a7f3c5b2e10
    ChargedUsd:
      description: What this call cost, in US dollars as an exact six-decimal string.
      schema:
        type: string
        example: '0.005000'
    BalanceUsd:
      description: >-
        The organization's balance after this call, in US dollars as an exact
        six-decimal string.
      schema:
        type: string
        example: '9.995000'
    RateLimitLimit:
      description: >-
        The calls allowed in the window of the route's limit with the fewest
        calls left.
      schema:
        type: integer
        example: 20
    RateLimitRemaining:
      description: The calls left in that window.
      schema:
        type: integer
        example: 19
    RateLimitReset:
      description: Seconds until that window resets.
      schema:
        type: integer
        example: 42
    RetryAfter:
      description: Seconds to wait before calling again.
      schema:
        type: integer
        example: 42
  responses:
    RateLimited:
      description: >-
        Too many calls. Wait the seconds in Retry-After, then call again. When
        the limit reached does not say when it resets, such as a mail provider's
        own limit on a mailbox, Retry-After is 60. The RateLimit headers
        describe this API's own limits, so they come only with a 429 one of
        those gave. The body is empty.
      headers:
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimitLimit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimitRemaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimitReset'
    Error:
      description: The request was refused. The body names the reason in `error.code`.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ServerError:
      description: >-
        Something failed on our side and nothing was charged. Retry with
        backoff; quote X-Request-Id if it persists. The body is empty.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - doc_url
          properties:
            code:
              type: string
              description: >-
                Stable and machine-readable: branch on it. It never changes
                meaning.
            message:
              type: string
              description: >-
                A human-readable explanation for logs. It may be reworded at any
                time.
            param:
              type: string
              description: The request field the error is about, when there is one.
            doc_url:
              type: string
              description: The code's entry in the errors reference.
            request_id:
              type: string
              description: >-
                The request's id, as in the X-Request-Id header. Quote it to
                support.
      example:
        error:
          code: insufficient_balance
          message: Your balance cannot cover this call. Add funds and try again.
          doc_url: https://docs.outbound.dev/errors#insufficient_balance
          request_id: req_6a1f0c2b9d4e8a7f3c5b2e10
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        An API key from the console, starting `ob_live_`, sent as
        `Authorization: Bearer <key>`.

````

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