category: Analytics & SIEM
provider: Twilio
commonfields:
  id: Twilio SendGrid
  version: -1
description: Twilio SendGrid is a cloud-based email delivery platform that provides email activity tracking and analytics.
display: Twilio SendGrid
name: Twilio SendGrid
sectionorder:
- Connect
- Collect
configuration:
- display: Server URL
  name: server_url
  defaultvalue: api.sendgrid.com
  type: 0
  required: true
  section: Connect
- display: API Secret Key
  name: api_key
  type: 9
  required: true
  section: Connect
  hiddenusername: true
  displaypassword: API Secret Key
- additionalinfo: Maximum number of email activity messages to fetch per fetch run. The API is limited to 1000 events per call, so multiple calls will be made if needed.
  defaultvalue: '10000'
  display: Maximum Email Activity Messages per fetch
  name: max_fetch
  type: 0
  required: false
  section: Collect
- defaultvalue: '1'
  display: Events Fetch Interval
  name: eventFetchInterval
  type: 19
  required: false
  section: Collect
  advanced: true
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  required: false
  section: Connect
  advanced: true
- display: Use system proxy settings
  name: proxy
  type: 8
  required: false
  section: Connect
  advanced: true
script:
  commands:
  - name: twilio-sendgrid-get-events
    description: Returns email activity events from Twilio SendGrid. This command is used for developing/debugging and is to be used with caution, as it can create events, leading to event duplication and exceeding the API request limitation.
    arguments:
    - auto: PREDEFINED
      defaultValue: 'false'
      description: Set this argument to True in order to create events, otherwise the command will only display them.
      name: should_push_events
      predefined:
      - 'true'
      - 'false'
      required: true
    - description: Maximum number of events to retrieve. The API is limited to 1000 events per call. Default is 10000.
      name: limit
      defaultValue: '1000'
      required: false
    - description: Start time for event retrieval. Supports relative times (e.g., "3 days") or ISO format (e.g., "2024-01-15T00:00:00Z").
      name: from_date
      required: false
    - description: End time for event retrieval. Supports relative times or ISO format.
      name: to_date
      required: false
  dockerimage: demisto/python3:3.12.13.10116658
  isfetchevents: true
  runonce: false
  script: ''
  subtype: python3
  type: python
fromversion: 8.4.0
marketplaces:
- marketplacev2
- platform
tests:
- No tests
supportedModules:
- xsiam