> For the complete documentation index, see [llms.txt](https://docs.ebbot.ai/ebbot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ebbot.ai/ebbot-docs/developer-resources/ebbot-automations/integrations-sdk/developing.md).

# Developing

This assumes you already [installed the SDK](broken://pages/DYDEfcEH0s318CRml8Y3) and set [things up for development](broken://pages/dgNgdggTF2qhMJEsIv5K#setting-up-the-server-for-development).

## Set Up Your Connection

You should start with setting up your connection. First, adjust your `Options` and `Secrets` so that you collect the necessary information for connecting to the external system you want to integrate with.

For example:

```python
from pydantic import BaseModel
from integrations_sdk.server import start_workflow_server


class Options(BaseModel):
    baseUrl: str


class Secrets(BaseModel):
    apiKey: str

app = start_workflow_server(
    "fns",
    "http://localhost:9000",
    "engine-api-key",
    Options,
    Secrets,
    dev_mode=True # Set to true.
)
```

## Test Creating Your Connection

[Start the server](broken://pages/dgNgdggTF2qhMJEsIv5K#starting-the-server) and go to <http://localhost:8000/docs>

You will be presented with the API documentation where you can test your server.

Creating a connection is done using the `POST /connections` endpoint:

Store the connection ID you get back and then close the server.

## Adding an Action

Let's add an [action](https://github.com/ebbot-ai/external-docs/blob/main/actions.md) by creating the directory `fns`, then create the file `fns/actions.py` and add the following action:

```python
from pydantic import BaseModel, Field
from integrations_sdk.component import workflow_action

class Result(BaseModel):
    result: str

@workflow_action(
    description="Hello world",
    result=Result,
    display_name="Say hello",
    docs="How the say_hello action works",
    arguments={}
)
def say_hello() -> Result:
    return Result(result=f"Hello world!")
```

Restart the server and head to <http://localhost:8000/docs> again. You will see a new endpoint, `POST /connections/{connection_id/call/say_hello`. Go ahead and try it out (with the ID of the connection you created in the first step):

## Read More

Check the documentation on [actions](https://github.com/ebbot-ai/external-docs/blob/main/actions.md) and [triggers](https://github.com/ebbot-ai/external-docs/blob/main/triggers/README.md) to read more.