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

# Set privacy

> Updates the seven privacy settings at once — **all are required** and a partial body is rejected. To change just one, read the current values with `GET /v1/profile/privacy`, change the field you want and resend all seven.



## OpenAPI

````yaml /en/api-reference/openapi.json post /profile/update-privacy
openapi: 3.1.0
info:
  title: Zapfy API
  description: >-
    Multi-tenant WhatsApp API. Send messages and manage webhooks through a
    single surface.
  version: 1.0.0
servers:
  - url: https://api.zapfy.io/v1
security:
  - accountToken: []
paths:
  /profile/update-privacy:
    post:
      tags:
        - Profile
      summary: Set privacy
      description: >-
        Updates the seven privacy settings at once — **all are required** and a
        partial body is rejected. To change just one, read the current values
        with `GET /v1/profile/privacy`, change the field you want and resend all
        seven.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PrivacySettings'
      responses:
        '200':
          $ref: '#/components/responses/PrivacyResult'
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '403':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
        - instanceToken: []
components:
  schemas:
    PrivacySettings:
      type: object
      required:
        - groupAdd
        - lastSeen
        - status
        - profile
        - readReceipts
        - callAdd
        - online
      properties:
        groupAdd:
          type: string
          enum:
            - ALL
            - CONTACTS
            - CONTACT_BLACKLIST
            - NONE
          description: >-
            Who can add you to groups. `ALL` = everyone; `CONTACTS` = all of
            your contacts; `CONTACT_BLACKLIST` = your contacts, excluding the
            ones you put on an exclusion list (WhatsApp's "My contacts except…"
            option); `NONE` = nobody.
          example: all
        lastSeen:
          type: string
          enum:
            - ALL
            - CONTACTS
            - CONTACT_BLACKLIST
            - NONE
          description: >-
            Who can see your "last seen". `ALL` = everyone; `CONTACTS` = all of
            your contacts; `CONTACT_BLACKLIST` = your contacts, excluding the
            ones you put on an exclusion list (WhatsApp's "My contacts except…"
            option); `NONE` = nobody.
          example: all
        status:
          type: string
          enum:
            - ALL
            - CONTACTS
            - CONTACT_BLACKLIST
            - NONE
          description: >-
            Who can see your status updates (stories). `ALL` = everyone;
            `CONTACTS` = all of your contacts; `CONTACT_BLACKLIST` = your
            contacts, excluding the ones you put on an exclusion list
            (WhatsApp's "My contacts except…" option); `NONE` = nobody.
          example: all
        profile:
          type: string
          enum:
            - ALL
            - CONTACTS
            - CONTACT_BLACKLIST
            - NONE
          description: >-
            Who can see your profile photo. `ALL` = everyone; `CONTACTS` = all
            of your contacts; `CONTACT_BLACKLIST` = your contacts, excluding the
            ones you put on an exclusion list (WhatsApp's "My contacts except…"
            option); `NONE` = nobody.
          example: all
        readReceipts:
          type: string
          enum:
            - ALL
            - NONE
          description: Read receipts (blue ticks). `ALL` = on; `NONE` = off.
          example: all
        callAdd:
          type: string
          enum:
            - ALL
            - KNOWN
          description: >-
            Who can add you to group calls. `ALL` = anyone; `KNOWN` = only known
            contacts.
          example: all
        online:
          type: string
          enum:
            - ALL
            - MATCH_LAST_SEEN
          description: >-
            Who can see when you are online. `ALL` = everyone; `MATCH_LAST_SEEN`
            = follows your "last seen" setting.
          example: all
  responses:
    PrivacyResult:
      description: Privacy settings.
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                $ref: '#/components/schemas/PrivacySettings'
    Error:
      description: Error.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Instance not found
  securitySchemes:
    accountToken:
      type: http
      scheme: bearer
      description: Account token (`zpfy_acct_...`) — manages instances and webhooks.
    instanceToken:
      type: http
      scheme: bearer
      description: Instance token (`zpfy_inst_...`) — sends messages.

````