> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Create Follow-up

- Component: `appmixer.superoffice.core.CreateFollowUp`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.superoffice 1.2.0](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.CreateFollowUp>

Create a follow-up (an appointment, task or call) in the diary or task list.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Start Date (`startDate`) | date-time | When the follow-up starts. |
| End Date (`endDate`) | date-time | When the follow-up ends. |
| Title (`title`) | text | - |
| Description (`description`) | textarea | Text of the follow-up. |
| Task (`taskId`) | text | The kind of follow-up (meeting, phone call, ...). Pick one, or type its ID. |
| Type (`type`) | select | Show the follow-up in the diary (with a time) or in the task list. |
| Location (`location`) | text | - |
| Company ID (`companyId`) | text | The company of the follow-up. Use Find Companies to look it up. |
| Person ID (`personId`) | text | The person of the follow-up. Use Find Persons to look it up. |
| Project ID (`projectId`) | text | The project of the follow-up. Use Find Projects to look it up. |
| Sale ID (`saleId`) | text | The sale of the follow-up. Use Find Sales to look it up. |
| Time Zone (`timeZone`) | text | Optional. The time zone of your SuperOffice tenant, for example Europe/Oslo. SuperOffice keeps date-times in the local time of the tenant; the time zone is detected automatically (reliably for European tenants) and this setting overrides it. Date-times the component returns are always in UTC. |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| Follow-up ID (`id`) | integer | - |
| Title (`title`) | string | - |
| Description (`description`) | string | - |
| Start Date (`startDate`) | string | - |
| End Date (`endDate`) | string | - |
| Task (`task`) | string | - |
| Type (`type`) | string | - |
| Completed (`completed`) | string | - |
| Location (`location`) | string | - |
| Company ID (`companyId`) | integer | - |
| Company Name (`companyName`) | string | - |
| Person ID (`personId`) | integer | - |
| Person Name (`personName`) | string | - |
| Project ID (`projectId`) | integer | - |
| Sale ID (`saleId`) | integer | - |
| Created Date (`createdDate`) | string | - |
| Updated Date (`updatedDate`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.superoffice.core.CreateFollowUp",
  "label": "Create Follow-up",
  "description": "Create a follow-up (an appointment, task or call) in the diary or task list.",
  "author": "Appmixer <info@appmixer.com>",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:superoffice"
  },
  "quota": {
    "manager": "appmixer:superoffice",
    "resources": "requests",
    "scope": {
      "userId": "{{userId}}"
    }
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "startDate": {
            "type": "string",
            "format": "date-time"
          },
          "endDate": {
            "type": "string",
            "format": "date-time"
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "taskId": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "inDiary",
              "inChecklist"
            ]
          },
          "location": {
            "type": "string"
          },
          "companyId": {
            "type": "string"
          },
          "personId": {
            "type": "string"
          },
          "projectId": {
            "type": "string"
          },
          "saleId": {
            "type": "string"
          },
          "timeZone": {
            "type": "string"
          }
        },
        "required": [
          "startDate",
          "endDate"
        ]
      },
      "inspector": {
        "inputs": {
          "startDate": {
            "type": "date-time",
            "index": 1,
            "label": "Start Date",
            "tooltip": "When the follow-up starts."
          },
          "endDate": {
            "type": "date-time",
            "index": 2,
            "label": "End Date",
            "tooltip": "When the follow-up ends."
          },
          "title": {
            "type": "text",
            "index": 3,
            "label": "Title"
          },
          "description": {
            "type": "textarea",
            "index": 4,
            "label": "Description",
            "tooltip": "Text of the follow-up."
          },
          "taskId": {
            "type": "text",
            "index": 5,
            "label": "Task",
            "tooltip": "The kind of follow-up (meeting, phone call, ...). Pick one, or type its ID.",
            "source": {
              "url": "/component/appmixer/superoffice/core/ListListItems?outPort=out",
              "data": {
                "properties": {
                  "isSource": true,
                  "listName": "Task"
                },
                "transform": "./ListListItems#toSelectArray"
              }
            }
          },
          "type": {
            "type": "select",
            "index": 6,
            "label": "Type",
            "tooltip": "Show the follow-up in the diary (with a time) or in the task list.",
            "options": [
              {
                "label": "Diary",
                "value": "inDiary"
              },
              {
                "label": "Task list",
                "value": "inChecklist"
              }
            ]
          },
          "location": {
            "type": "text",
            "index": 7,
            "label": "Location"
          },
          "companyId": {
            "type": "text",
            "index": 8,
            "label": "Company ID",
            "tooltip": "The company of the follow-up. Use Find Companies to look it up."
          },
          "personId": {
            "type": "text",
            "index": 9,
            "label": "Person ID",
            "tooltip": "The person of the follow-up. Use Find Persons to look it up."
          },
          "projectId": {
            "type": "text",
            "index": 10,
            "label": "Project ID",
            "tooltip": "The project of the follow-up. Use Find Projects to look it up."
          },
          "saleId": {
            "type": "text",
            "index": 11,
            "label": "Sale ID",
            "tooltip": "The sale of the follow-up. Use Find Sales to look it up."
          },
          "timeZone": {
            "type": "text",
            "index": 12,
            "label": "Time Zone",
            "tooltip": "Optional. The time zone of your SuperOffice tenant, for example Europe/Oslo. SuperOffice keeps date-times in the local time of the tenant; the time zone is detected automatically (reliably for European tenants) and this setting overrides it. Date-times the component returns are always in UTC.",
            "source": {
              "url": "/component/appmixer/superoffice/core/ListTimeZones?outPort=out",
              "data": {
                "transform": "./ListTimeZones#toSelectArray"
              }
            }
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "schema": {
        "type": "object",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "title": "Follow-up ID",
            "example": 981
          },
          "title": {
            "type": "string",
            "title": "Title",
            "example": "Kick-off meeting"
          },
          "description": {
            "type": "string",
            "title": "Description",
            "example": "Agree on the project plan."
          },
          "startDate": {
            "type": "string",
            "title": "Start Date",
            "example": "2026-11-20T09:00:00Z"
          },
          "endDate": {
            "type": "string",
            "title": "End Date",
            "example": "2026-11-20T10:00:00Z"
          },
          "task": {
            "type": "string",
            "title": "Task",
            "example": "Meeting"
          },
          "type": {
            "type": "string",
            "title": "Type",
            "example": "inDiary"
          },
          "completed": {
            "type": "string",
            "title": "Completed",
            "example": "NotStarted"
          },
          "location": {
            "type": "string",
            "title": "Location",
            "example": "Meeting room 1"
          },
          "companyId": {
            "type": "integer",
            "title": "Company ID",
            "example": 125
          },
          "companyName": {
            "type": "string",
            "title": "Company Name",
            "example": "Acme Inc."
          },
          "personId": {
            "type": "integer",
            "title": "Person ID",
            "example": 342
          },
          "personName": {
            "type": "string",
            "title": "Person Name",
            "example": "Jane Doe"
          },
          "projectId": {
            "type": "integer",
            "title": "Project ID",
            "example": 12
          },
          "saleId": {
            "type": "integer",
            "title": "Sale ID",
            "example": 57
          },
          "createdDate": {
            "type": "string",
            "title": "Created Date",
            "example": "2026-11-16T10:30:00Z"
          },
          "updatedDate": {
            "type": "string",
            "title": "Updated Date",
            "example": "2026-11-17T08:15:00Z"
          }
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
