{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"**This endpoint allows you to create a new alert.**","properties":{"headers":{"type":"object","properties":{"on-behalf-of":{"type":"string","description":"The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id <account-id>`). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: <subuser-username>`). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information."}},"required":[],"additionalProperties":false},"body":{"type":"object","properties":{"type":{"allOf":[{"$ref":"#/definitions/Type"},{"type":"string"}]},"email_to":{"type":["string","null"],"description":"The email address the alert will be sent to.\nExample: test@example.com","format":"email"},"frequency":{"type":"string","description":"Required for stats_notification. How frequently the alert will be sent.\nExample: daily"},"percentage":{"type":"integer","description":"Required for usage_limit. When this usage threshold is reached, the alert will be sent.\nExample: 90"}},"required":["type","email_to"],"examples":[{"type":"stats_notification","email_to":"example@example.com","frequency":"daily"}]}},"required":[],"additionalProperties":false,"definitions":{"Type":{"type":"string","enum":["stats_notification","usage_limit"]}}},"name":"Create a new Alert","id":"sendgrid.alerts.createalert","example":{},"maxRequests":1,"summary":false}}