- AnsibleFest
- Products
- Community
- Webinars & Training
- Blog

Documentation

# office_365_connector_card – Use webhooks to create Connector Card messages within an Office 365 group

New in version 2.4.

- Synopsis
- Parameters
- Notes
- Examples
- Status

## Synopsis

- Creates Connector Card messages through
- Office 365 Connectors https://dev.outlook.com/Connectors

## Parameters

Parameter | Choices/Defaults | Comments
--- | --- | ---
actions - |  | This array of objects will power the action links found at the bottom of the card.
color - |  | Accent color used for branding or indicating status in the card.
sections - |  | Contains a list of sections to display in the card. For more information see https://dev.outlook.com/Connectors/reference.
summary - |  | A string used for summarizing card content. This will be shown as the message subject. This is required if the text parameter isn't populated.
text - |  | The main text of the card. This will be rendered below the sender information and optional title, and above any sections or actions present.
title - |  | A title for the Connector message. Shown at the top of the message.
webhook - / required |  | The webhook URL is given to you when you create a new Connector.

## Notes

Note

- This module is not idempotent, therefore if the same task is run twice there will be two Connector Cards created

## Examples

    - name: Create a simple Connector Card
      office_365_connector_card:
        webhook: https://outlook.office.com/webhook/GUID/IncomingWebhook/GUID/GUID
        text: 'Hello, World!'

    - name: Create a Connector Card with the full format
      office_365_connector_card:
        webhook: https://outlook.office.com/webhook/GUID/IncomingWebhook/GUID/GUID
        summary: This is the summary property
        title: This is the **card's title** property
        text: This is the **card's text** property. Lorem ipsum dolor sit amet, consectetur
          adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
        color: E81123
        sections:
        - title: This is the **section's title** property
          activity_image: http://connectorsdemo.azurewebsites.net/images/MSC12_Oscar_002.jpg
          activity_title: This is the section's **activityTitle** property
          activity_subtitle: This is the section's **activitySubtitle** property
          activity_text: This is the section's **activityText** property.
          hero_image:
            image: http://connectorsdemo.azurewebsites.net/images/WIN12_Scene_01.jpg
            title: This is the image's alternate text
          text: This is the section's text property. Lorem ipsum dolor sit amet, consectetur
            adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
          facts:
          - name: This is a fact name
            value: This is a fact value
          - name: This is a fact name
            value: This is a fact value
          - name: This is a fact name
            value: This is a fact value
          images:
          - image: http://connectorsdemo.azurewebsites.net/images/MicrosoftSurface_024_Cafe_OH-06315_VS_R1c.jpg
            title: This is the image's alternate text
          - image: http://connectorsdemo.azurewebsites.net/images/WIN12_Scene_01.jpg
            title: This is the image's alternate text
          - image: http://connectorsdemo.azurewebsites.net/images/WIN12_Anthony_02.jpg
            title: This is the image's alternate text
          actions:
          - "@type": ActionCard
            name: Comment
            inputs:
            - "@type": TextInput
              id: comment
              is_multiline: true
              title: Input's title property
            actions:
            - "@type": HttpPOST
              name: Save
              target: http://...
          - "@type": ActionCard
            name: Due Date
            inputs:
            - "@type": DateInput
              id: dueDate
              title: Input's title property
            actions:
            - "@type": HttpPOST
              name: Save
              target: http://...
          - "@type": HttpPOST
            name: Action's name prop.
            target: http://...
          - "@type": OpenUri
            name: Action's name prop
            targets:
            - os: default
              uri: http://...
        - start_group: true
          title: This is the title of a **second section**
          text: This second section is visually separated from the first one by setting its
            **startGroup** property to true.

## Status

- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]

### Authors

- Marc Sensenich (@marc-sensenich)

Hint

If you notice any issues in this documentation, you can edit this document to improve it.