> For the complete documentation index, see [llms.txt](https://docs.struct.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.struct.com/tutorials/guides/how-to-use-app-integration.md).

# How to use app integration

App integration is a powerful tool that opens up for new functionality to be added to the PIM through custom apps.

## What is app integration?

App integrations in Struct PIM are designed to extend the core platform with your own tailored functionality. By using custom apps, you can access specialized functionality directly within your existing Struct PIM workplace. An app integration consists of general settings and extension points.

General settings contain the administrative metadata for the app, including the name and description. This section also defines the messaging version of the API used for communication and provides the option to set the app as active or inactive within the system.

Extension points cover the specific means of connecting the app to the PIM interface. Within this section, each extension is given a label which automatically generates a unique key upon creation to ensure proper version matching.&#x20;

The extensions also include descriptions and various types that determine exactly where and how the custom functionality is reflected in the PIM. Depending on the [type](/reference/settings/integration/apps/apps-details/extension-points/extension-point-types.md) selected, an extension can appear anywhere from a dedicated tab to a widget on the dashboard.&#x20;

Each extension contains an embedded URL to locate the hosted application along with a thumbnail URL used to visually represent the app when adding widget-style extensions to the dashboard.

## Guides covering app integration

* [How to set up and edit an app integration](/tutorials/guides/how-to-use-app-integration/how-to-set-up-and-edit-an-app-integration.md)
* [Example of weather app widget extension](/developer/app-integration/example-projects.md)
* [Quickstart for developers](/developer/app-integration/quickstart.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.struct.com/tutorials/guides/how-to-use-app-integration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
