--- title: "Contentful Connector | Lansweeper Platform" slug: "contentful-connector" description: "Manage Spaces, Environments, and Organizations in Contentful with OAuth 2.0. Create, update, and delete assets, webhooks, and more seamlessly." status: "update" updated: 2026-07-17T15:53:40Z published: 2026-07-17T15:53:40Z canonical: "docs.lansweeper.com/contentful-connector" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.lansweeper.com/llms.txt > Use this file to discover all available pages before exploring further. # Contentful Connector Note on third‑party tools We aim to provide accurate and helpful details about third‑party tools, but we can’t guarantee that this information is always complete or up to date. If you notice any discrepancies, feel free to share them in the feedback section below. For the most reliable information, please always refer to the third‑party tool’s official documentation. [Contentful](https://www.contentful.com/) is a content management system (CMS) that allows developers to manage and deliver content across multiple platforms and devices. The Contentful component allows managing spaces, environments, content types, entries, assets, organizations, webhooks, and bulk actions. ## API Documentation This component was built using the [Contentful Content Management API Reference](https://www.contentful.com/developers/docs/references/content-management-api/#/introduction). ## Connections ### OAuth 2.0 Authenticate using OAuth 2.0. To connect to Contentful, create a new OAuth application. #### Prerequisites - A Contentful account with developer access #### Setup Steps 1. Navigate to the Developer [Account Settings](https://app.contentful.com/account/profile/developers/applications) for OAuth applications 2. Click **Create New Application** 3. Enter the **Redirect URI** as `https://oauth2.flowbuilder.eu.lansweeper.com/callback` for EU sites or `https://oauth2.flowbuilder.us.lansweeper.com/callback` for US sites 4. Select **Confidential** for the client type 5. Select the applicable scope (e.g., **Content management manage**) 6. Save the application 7. Copy the **Client ID** and **Client Secret** Single Scope Requirement Contentful only accepts a single scope per authorization request. The `content_management_manage` scope includes read access, so a separate `content_management_read` scope is not needed. #### Available Scopes | Scope | Description | | --- | --- | | `content_management_manage` | Manage and read content in all Spaces | | `content_management_read` | Read content in all Spaces | #### Configure the Connection Create a connection of type **OAuth 2.0** and enter: - **Client ID**: Enter the Client ID from the OAuth application - **Client Secret**: Enter the Client Secret from the OAuth application - **Scopes**: Enter a single scope (e.g., `content_management_manage`) This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works [here](/docs/oauth-20-connections). | Input | Comments | Default | | --- | --- | --- | | Scopes | A single OAuth 2.0 scope. Contentful accepts one scope per authorization. Valid values: content_management_manage, content_management_read. The manage scope includes read access. | content_management_manage | | Client ID | The Client ID from the OAuth application credentials. | | | Client Secret | The Client Secret from the OAuth application credentials. | | ## Triggers ### Event Subscription Receive event notifications from Contentful. Automatically creates and manages a webhook subscription for selected topics when the instance is deployed, and removes the subscription when the instance is deleted. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Events | The event types to subscribe to for this webhook. | | ### New and Updated Entries Checks for new and updated entries in a selected Contentful environment on a configured schedule. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Content Type ID | Restrict polling to a single content type. Leave blank to poll all entries in the environment. | | | Show New Entries | When true, entries whose `sys.createdAt` falls after the last poll are emitted on the `created` branch. | true | | Show Updated Entries | When true, entries whose `sys.updatedAt` falls after the last poll but were created earlier are emitted on the `updated` branch. | true | ### Webhook Receive and validate webhook requests from Contentful for webhooks you configure. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | ## Actions ### Archive Entry Archives an existing entry. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Entry ID | The unique identifier for the entry. | | ### Create Asset Creates a new asset. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Title | The title of the asset as a JSON object with locale keys. | `{ "en-US": "Example Asset"}` | | Description | The description of the asset as a JSON object with locale keys. | `{ "en-US": "Streamliner description"}` | | File | The file metadata for the asset as a JSON object with locale keys and upload details. | `{ "en-US": { "contentType": "image/jpeg", "fileName": "example.jpeg", "upload": "https://example.com/example.jpg" }}` | ### Create Content Type Creates a new content type. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Content Type Name | The display name for the content type. | | | Content Type Fields | The field definitions for the content type as a JSON array of field objects. | `[ { "id": "title", "name": "Title", "required": true, "localized": true, "type": "Text" }, { "id": "body", "name": "Body", "required": true, "localized": true, "type": "Text" }]` | | Display Field | The field used as the main display field for entries of this content type. | | | Description | A brief explanation of what this content type is used for in the content model. | | ### Create Entry Creates a new entry in a space. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Content Type ID | The unique identifier for the content type. | | | Entry Data | The entry data as a JSON object containing fields and their values. | | ### Create Environment Creates a new environment. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Environment Name | The display name for the environment. | | ### Create Space Creates a new space. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Organization ID | The unique identifier for the organization. | | | Space Name | The display name for the space. | | | Default Locale | The default locale code for the space. | | ### Create Webhook Creates a new webhook. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Name | A descriptive label to identify the webhook in the Contentful dashboard. | | | URL | The URL where webhook events will be sent. | | | Events | The event types to subscribe to for this webhook. | | ### Delete Asset Deletes an existing asset. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Asset ID | The unique identifier for the asset. | | ### Delete Entry Deletes an existing entry. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Entry ID | The unique identifier for the entry. | | ### Delete Environment Deletes an existing environment. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | ### Delete Instanced Webhooks Deletes all webhooks that point to a flow in the current instance. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | ### Delete Space Deletes an existing space. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | ### Delete Upload Deletes a file from temporary data storage. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Upload ID | The unique identifier for the upload. | | ### Delete Webhook Deletes an existing webhook. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Webhook ID | The unique identifier for the webhook. | | ### Get Asset Retrieves a single asset by ID. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Asset ID | The unique identifier for the asset. | | ### Get Bulk Action Retrieves a bulk action by ID. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Bulk Action ID | The unique identifier for the bulk action. | | ### Get Entry Retrieves a single entry by ID. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Entry ID | The unique identifier for the entry. | | ### Get Environment Retrieves a single environment by ID. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | ### Get Organization Retrieves an organization by ID. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Organization ID | The unique identifier for the organization. | | ### Get Space Retrieves a single space by ID. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | ### Get Upload Retrieves an unmodified image. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Upload ID | The unique identifier for the upload. | | ### Get Webhook Retrieves a single webhook by ID. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Webhook ID | The unique identifier for the webhook. | | ### List Assets Retrieves all assets of a space. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | ### List Content Types Retrieves all content types of a space. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | ### List Entries Retrieves all entries of a space. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | ### List Environments Retrieves all environments in a space. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | ### List Organizations Retrieves all organizations the account has access to. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | ### List Published Entries Retrieves all published entries of a space. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | ### List Spaces Retrieves all spaces the account has access to. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | ### List Webhooks Retrieves all webhooks of a space. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | ### Patch Entry Applies partial updates to an entry using JSON Patch (RFC 6902) operations. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Entry ID | The unique identifier for the entry. | | | Patch Operations | A JSON array of JSON Patch (RFC 6902) operations. | | | Entry Version | The current version number of the entry. Required for optimistic locking. | | ### Process Asset Processes an asset for content delivery. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Asset ID | The unique identifier for the asset. | | ### Publish Asset Publishes an asset. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Asset ID | The unique identifier for the asset. | | ### Publish Bulk Action Publishes a bulk action. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Items | The items to be processed in the bulk action as a JSON object containing entities and actions. | `[ { "sys": { "linkType": "Entry", "type": "Link", "id": "<entry_id>", "version": 2 } }, { "sys": { "linkType": "Asset", "type": "Link", "id": "<asset_id>", "version": 1 } }]` | ### Publish Entry Publishes an entry. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Entry ID | The unique identifier for the entry. | | ### Put Entry Replaces all fields of an existing entry with the provided data. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Entry ID | The unique identifier for the entry. | | | Entry Data | The full entry data as a JSON object. All existing fields will be replaced with the provided data. | | ### Raw Request Sends a raw HTTP request to the Contentful API. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | URL | Input the path only (/spaces), The base URL is already included (https://api.contentful.com). For example, to connect to https://api.contentful.com/spaces, only /spaces is entered in this field. | | | Method | The HTTP method to use. | | | Data | The HTTP body payload to send to the URL. | | | Form Data | The Form Data to be sent as a multipart form upload. | | | File Data | File Data to be sent as a multipart form upload. | | | File Data File Names | File names to apply to the file data inputs. Keys must match the file data keys above. | | | Query Parameter | A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2. | | | Header | A list of headers to send with the request. | | | Response Type | The type of data you expect in the response. You can request json, text, or binary data. | json | | Timeout | The maximum time that a client will await a response to its request | | | Retry Delay (ms) | The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. | 0 | | Retry On All Errors | If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. | false | | Max Retry Count | The maximum number of retries to attempt. Specify 0 for no retries. | 0 | | Use Exponential Backoff | Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. | false | ### Unarchive Entry Unarchives an existing entry. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Entry ID | The unique identifier for the entry. | | ### Unpublish Asset Unpublishes an asset. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Asset ID | The unique identifier for the asset. | | ### Unpublish Bulk Action Unpublishes a bulk action. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Items | The items to be unpublished in the bulk action as a JSON object containing entities to unpublish. | `[ { "sys": { "linkType": "Entry", "type": "Link", "id": "<entry_id>" } }, { "sys": { "linkType": "Asset", "type": "Link", "id": "<asset_id>" } }]` | ### Unpublish Entry Unpublishes an entry. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Entry ID | The unique identifier for the entry. | | ### Update Asset Updates an existing asset. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Asset ID | The unique identifier for the asset. | | | Title | The updated title of the asset. Locale key must match the original locale of the asset to be updated. | `{ "en-US": "Example Asset"}` | | Asset Description | The updated description of the asset. Locale key must match the original locale of the asset to be updated. | `{ "en-US": "Streamliner description"}` | ### Update Content Type Updates an existing content type. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Content Type ID | The unique identifier for the content type. | | | Content Type Name | The updated name for the content type. | | | Content Type Fields | The updated field definitions for the content type. | `[ { "id": "title", "name": "Title", "required": true, "localized": true, "type": "Text" }, { "id": "body", "name": "Body", "required": true, "localized": true, "type": "Text" }]` | | Display Field | The updated field used as the main display field for entries. | | | Description | The updated description for the content type. | | ### Update Environment Updates an existing environment. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Environment ID | The unique identifier for the Contentful environment. | | | Environment Name | The updated name for the environment. | | ### Update Organization Updates the security contact for an organization. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Organization ID | The unique identifier for the organization. | | | Security ID | The unique identifier for the security contact. | | ### Update Space Updates an existing space. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Space Name | The updated name for the space. | | ### Update Webhook Updates an existing webhook. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | Name | The updated name for the webhook. | | | Webhook ID | The unique identifier for the webhook. | | ### Upload File Uploads a file to temporary file storage. | Input | Comments | Default | | --- | --- | --- | | Connection | The Contentful connection to use. | | | Space ID | The unique identifier for the Contentful space. | | | File Contents | The contents to write to a file. This can be a string of text, it can be binary data that was generated in a previous step. | |