An example Go application demonstrating how to use the WorkOS Go SDK for directory sync.

• Go

1. Clone this git repository using your preferred secure method (HTTPS or SSH).

   # HTTPS
   git clone https://github.com/workos/go-example-applications.git

   or

   # SSH
   git clone [email protected]:workos/go-example-applications.git

2. Navigate to the cloned repository.

   cd go-example-applications/go-directory-sync-example

3. Obtain and make note of the following values. In the next step, these will be set as environment variables.

   • Your WorkOS API key
   • Your Directory ID
   • Your WorkOS Webhook Signing Secret (optional)

4. Create a file called ".env" in the root of the project and add the following environment variables, replacing xxx with the values from your WorkOS dashboard.

   • WORKOS_API_KEY=xxx
   • WORKOS_DIRECTORY_ID=xxx
   • WORKOS_WEBHOOK_SECRET=xxx

5. The final setup step is to start the server.

   go run .

   You'll know the server is running when you see no errors in the CLI.

   Navigate to localhost:8000 in your web browser. You should see a "Users" button. If you click this link, you should see your users list.

   You can navigate to localhost:8000/webhooks to view incoming webhooks in your console. We recommend using ngrok to test locally.

   You can stop the local server for now by entering CTRL + c on the command-line.

If you get stuck and aren't able to resolve the issue by reading our API reference or tutorials, you can reach out to us at [email protected] and we'll lend a hand.