> ## Documentation Index
> Fetch the complete documentation index at: /dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Let your users connect GitHub. Constella keeps it in sync.

| | |
| - | - |
| Integration name | `github` |
| What syncs | Pull requests and issues from the user's repositories, with who wrote them. Commits are not copied. |
| What your app can do | Search issues and pull requests, read one. See the exact list with [List actions](/dev/docs/api-reference/apps/list-actions.md). |

## Connect a user

```bash theme={"system"}
curl https://api.constella.app/platform/v1/users/u_123/connect-links \
  -H "Authorization: Bearer $CONSTELLA_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"integration": "github", "return_url": "https://yourapp.com/connected"}'
```

Send the user to the `url` you get back. When the first sync is done, your [webhook](/dev/docs/build/webhooks.md) gets `sync.initial_completed`. The whole flow is in [Sync your users' apps](/dev/docs/build/sync-apps.md).

## Find what synced

```bash theme={"system"}
curl https://api.constella.app/platform/v1/users/u_123/search \
  -H "Authorization: Bearer $CONSTELLA_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"queries": ["project kickoff"], "integrations": ["github"]}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.