---
title: "updateOrganizationEngagementSettings"
method: PUT
path: "/engagement-settings/{id}"
tags: ["Engagement Settings"]
---

# updateOrganizationEngagementSettings

`PUT /engagement-settings/{id}`

Update Engagement Settings for Organization

## Path parameters

- `id` string, required

## Request body

- EngagementSettingsFillable
  - `email_subdomain` string — Email subdomain
  - `sms` object — Details of Engagement Settings for SMS
    - `enabled` boolean — Indicates whether SMS is enabled or not in Engagement Settings
    - `phone_numbers` string[] — Phone numbers for sending SMS
    - `custom_caller_id` string, nullable — Custom Caller ID name for sending SMS
  - `email` object — Details of Engagement Settings for email
    - `custom_domain` boolean — Indicates whether custom domain for email is true or false
    - `domain_prefix` string — Domain prefix name for email
    - `email_domain` string — Domain name for email
    - `enabled` boolean — Indicates whether email is enabled or not
    - `throttling` object — Details of throttling:The amount of email messages sent to one ISP or remote server at one tim
      - `emails_per_day` integer — Number of emails sent per day
      - `emails_per_month` integer — Number of emails sent per month
    - `dns` object — Details of DNS settings
      - `is_valid` boolean — Indicates whether DNS is valid or not
      - `spf` object — A type of DNS record that identifies which mail servers are permitted to send an email on behalf of your domain
        - `txt_record` string — Name of SPF records to be included
        - `valid` boolean — Indicates whether SPF is valid or not
      - `dkim` object — DKIM Records include a signature in each email header sent
        - `txt_record` string — Signature in each email header sent
        - `valid` boolean — Indicates if DKIM is valid or not
      - `tracking` object — Details of Tracking
        - `cname` string — Cname allow for tracking of opens and clicks
        - `value` string — Value for tracking
        - `valid` boolean — Indicates whether tracking is valid or not
      - `incoming` object — Details of Incoming
        - `mx_records` object[] — The MX-record contains the host name of the computer(s) that handle the emails for a domain and a prioritization code
          - `priority` number — Each MX record has a priority, or a number to designate the order in which your domain name's incoming mail servers receive your email messages
          - `value` string — A mail exchanger record (MX record) specifies the mail server responsible for accepting email messages on behalf of a domain name
        - `valid` boolean — Indicates whether incoming is valid or not

## Response `200`

Success

- EngagementSettings
  - `id` string — Primary identifier of Engagement Settings
  - `organization_id` integer — ID of the Organization for which Engagement settings belongs
  - `created_at` string, date-time — Date/time of initial Engagement Settings creation
  - `updated_at` string, date-time — Date/time of Engagement Settings last updated
  - `email_subdomain` string — Email subdomain
  - `sms` object — Details of Engagement Settings for SMS
    - `enabled` boolean — Indicates whether SMS is enabled or not in Engagement Settings
    - `phone_numbers` string[] — Phone numbers for sending SMS
    - `custom_caller_id` string, nullable — Custom Caller ID name for sending SMS
  - `email` object — Details of Engagement Settings for email
    - `custom_domain` boolean — Indicates whether custom domain for email is true or false
    - `domain_prefix` string — Domain prefix name for email
    - `email_domain` string — Domain name for email
    - `enabled` boolean — Indicates whether email is enabled or not
    - `throttling` object — Details of throttling:The amount of email messages sent to one ISP or remote server at one tim
      - `emails_per_day` integer — Number of emails sent per day
      - `emails_per_month` integer — Number of emails sent per month
    - `dns` object — Details of DNS settings
      - `is_valid` boolean — Indicates whether DNS is valid or not
      - `spf` object — A type of DNS record that identifies which mail servers are permitted to send an email on behalf of your domain
        - `txt_record` string — Name of SPF records to be included
        - `valid` boolean — Indicates whether SPF is valid or not
      - `dkim` object — DKIM Records include a signature in each email header sent
        - `txt_record` string — Signature in each email header sent
        - `valid` boolean — Indicates if DKIM is valid or not
      - `tracking` object — Details of Tracking
        - `cname` string — Cname allow for tracking of opens and clicks
        - `value` string — Value for tracking
        - `valid` boolean — Indicates whether tracking is valid or not
      - `incoming` object — Details of Incoming
        - `mx_records` object[] — The MX-record contains the host name of the computer(s) that handle the emails for a domain and a prioritization code
          - `priority` number — Each MX record has a priority, or a number to designate the order in which your domain name's incoming mail servers receive your email messages
          - `value` string — A mail exchanger record (MX record) specifies the mail server responsible for accepting email messages on behalf of a domain name
        - `valid` boolean — Indicates whether incoming is valid or not

## Other responses

- `403` — Requester is not authorized to perform action
- `404` — Engagement Settings not found

---

[API](https://skmtc.net/gofundme/apis/gofundme-pro-api.md) · [All operations](https://skmtc.net/gofundme/apis/gofundme-pro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gofundme/gofundme-pro-api/versions/d22bb925eeed/schema)