# Notifications

# Emails

Receive notifications in your email inbox. Simple, yet effective.

# Add Notification Emails

POST /api/v1/flock/settings/notifications/email/add

Add a new email(s) to the notifications list.

Required Parameters

auth_token string
A valid auth token
flock_id string
A valid flock_id
addresses string
A comma separated list of valid email addresses to add

Response

A JSON structure with result indicator.

Example

    Response
    {
      "result": "success"
    }
    
    1
    2
    3

    # Check if Notification Emails are Enabled

    GET /api/v1/flock/settings/notifications/email/is_enabled

    Check if notification emails are enabled for a Flock.

    Required Parameters

    auth_token string
    A valid auth token
    flock_id string
    A valid flock_id

    Response

    A JSON structure with the enabled state.

    Example

      Response
      {
        "is_enabled": true,
        "result": "success"
      }
      
      1
      2
      3
      4

      # Check if Notification Emails are Global

      GET /api/v1/flock/settings/notifications/email/is_global

      Check if notification emails are set to Global for a Flock.

      Required Parameters

      auth_token string
      A valid auth token
      flock_id string
      A valid flock_id

      Response

      A JSON structure with the Global state.

      Example

        Response
        {
          "is_global": true,
          "result": "success"
        }
        
        1
        2
        3
        4

        # Disable Notification Emails

        POST /api/v1/flock/settings/notifications/email/disable

        Disable notification emails for a Flock.

        Required Parameters

        auth_token string
        A valid auth token
        flock_id string
        A valid flock_id

        Response

        A JSON structure with result indicator.

        Example

          Response
          {
            "result": "success"
          }
          
          1
          2
          3

          # Enable Notification Emails

          POST /api/v1/flock/settings/notifications/email/enable

          Enable notification emails for a Flock.

          Required Parameters

          auth_token string
          A valid auth token
          flock_id string
          A valid flock_id

          Response

          A JSON structure with result indicator.

          Example

            Response
            {
              "result": "success"
            }
            
            1
            2
            3

            # List Notification Emails

            GET /api/v1/flock/settings/notifications/email

            Retrieve the list of notification emails for a Flock.

            Required Parameters

            auth_token string
            A valid auth token
            flock_id string
            A valid flock_id

            Response

            A JSON structure with the list of notification emails.

            Example

              Response
              {
                "emails": [
                  "<email_address>",
                  "<email_address>"
                ],
                "result": "success"
              }
              
              1
              2
              3
              4
              5
              6
              7

              # Set Notification Emails

              POST /api/v1/flock/settings/notifications/email/save

              Set the email notification list for a Flock

              Required Parameters

              auth_token string
              A valid auth token
              flock_id string
              A valid flock_id

              Optional Parameters

              addresses string
              A comma separated list of valid email addresses
              clear boolean
              If set to true, clears the list of email addresses

              Response

              A JSON structure with result indicator.

              Example

                Response
                {
                  "result": "success"
                }
                
                1
                2
                3

                # Use Global for Notification Emails

                POST /api/v1/flock/settings/notifications/email/use_global

                Set the Flock's notification email state to Global.

                Required Parameters

                auth_token string
                A valid auth token
                flock_id string
                A valid flock_id

                Response

                A JSON structure with result indicator.

                Example

                  Response
                  {
                    "result": "success"
                  }
                  
                  1
                  2
                  3

                  # SMS

                  Receive notifications directly to your cellphone. Simple, yet effective.

                  # Add Notification Numbers

                  POST /api/v1/flock/settings/notifications/sms/add

                  Add new cellphone numbers to the notifications list.

                  Required Parameters

                  auth_token string
                  A valid auth token
                  flock_id string
                  A valid flock_id
                  numbers string
                  A comma separated list of valid cellphone numbers to add

                  Response

                  A JSON structure with result indicator.

                  Example

                    Response
                    {
                      "result": "success"
                    }
                    
                    1
                    2
                    3

                    # Check if SMS Notifications are Enabled

                    GET /api/v1/flock/settings/notifications/sms/is_enabled

                    Check if SMS notifications are enabled for a Flock.

                    Required Parameters

                    auth_token string
                    A valid auth token
                    flock_id string
                    A valid flock_id

                    Response

                    A JSON structure with the enabled state.

                    Example

                      Response
                      {
                        "is_enabled":true,
                        "result":"success"
                      }
                      
                      1
                      2
                      3
                      4

                      # Check if SMS Notifications are Global

                      GET /api/v1/flock/settings/notifications/sms/is_global

                      Check if SMS notifications are set to Global for a Flock.

                      Required Parameters

                      auth_token string
                      A valid auth token
                      flock_id string
                      A valid flock_id

                      Response

                      A JSON structure with the Global state.

                      Example

                        Response
                        {
                          "is_global": true,
                          "result": "success"
                        }
                        
                        1
                        2
                        3
                        4

                        # Disable SMS Notifications

                        POST /api/v1/flock/settings/notifications/sms/disable

                        Disable SMS notifications for a Flock.

                        Required Parameters

                        auth_token string
                        A valid auth token
                        flock_id string
                        A valid flock_id

                        Response

                        A JSON structure with result indicator.

                        Example

                          Response
                          {
                            "result": "success"
                          }
                          
                          1
                          2
                          3

                          # Enable SMS Notifications

                          POST /api/v1/flock/settings/notifications/sms/enable

                          Enable SMS notifications for a Flock.

                          Required Parameters

                          auth_token string
                          A valid auth token
                          flock_id string
                          A valid flock_id

                          Response

                          A JSON structure with result indicator.

                          Example

                            Response
                            {
                              "result": "success"
                            }
                            
                            1
                            2
                            3

                            # List Notification Numbers

                            GET /api/v1/flock/settings/notifications/sms

                            Retrieve the list of notification numbers for a Flock.

                            Required Parameters

                            auth_token string
                            A valid auth token
                            flock_id string
                            A valid flock_id

                            Response

                            A JSON structure with the list of notification numbers.

                            Example

                              Response
                              {
                                "numbers": [
                                  "<cellphone_number>",
                                  "<cellphone_number"
                                ],
                                "result": "success"
                              }
                              
                              1
                              2
                              3
                              4
                              5
                              6
                              7

                              # Set Notification Numbers

                              POST /api/v1/flock/settings/notifications/sms/save

                              Set the SMS notification list for a Flock

                              Required Parameters

                              auth_token string
                              A valid auth token
                              flock_id string
                              A valid flock_id

                              Optional Parameters

                              addresses string
                              A comma separated list of valid cellphone numbers
                              clear boolean
                              If set to true, clears the list of cellphone numbers

                              Response

                              A JSON structure with result indicator.

                              Example

                                Response
                                {
                                  "result": "success"
                                }
                                
                                1
                                2
                                3

                                # Use Global for SMS Notifications

                                POST /api/v1/flock/settings/notifications/sms/use_global

                                Set the Flock's SMS notification state to Global.

                                Required Parameters

                                auth_token string
                                A valid auth token
                                flock_id string
                                A valid flock_id

                                Response

                                A JSON structure with result indicator.

                                Example

                                  Response
                                  {
                                    "result": "success"
                                  }
                                  
                                  1
                                  2
                                  3