{"id":15490510,"url":"https://github.com/theodesp/go-calendly","last_synced_at":"2025-04-22T19:11:00.371Z","repository":{"id":57663486,"uuid":"142551986","full_name":"theodesp/go-calendly","owner":"theodesp","description":"go-calendly is a Go client library for accessing the Calendly API https://godoc.org/github.com/theodesp/go-calendly/calendly","archived":false,"fork":false,"pushed_at":"2018-07-31T14:55:55.000Z","size":43,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-19T09:18:29.500Z","etag":null,"topics":["calendly","go"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theodesp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-07-27T08:43:58.000Z","updated_at":"2023-04-16T21:46:45.000Z","dependencies_parsed_at":"2022-09-17T19:23:22.808Z","dependency_job_id":null,"html_url":"https://github.com/theodesp/go-calendly","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theodesp%2Fgo-calendly","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theodesp%2Fgo-calendly/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theodesp%2Fgo-calendly/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theodesp%2Fgo-calendly/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theodesp","download_url":"https://codeload.github.com/theodesp/go-calendly/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250306638,"owners_count":21408926,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["calendly","go"],"created_at":"2024-10-02T07:21:46.563Z","updated_at":"2025-04-22T19:11:00.326Z","avatar_url":"https://github.com/theodesp.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# go-calendly\n\n\u003ca href=\"https://godoc.org/github.com/theodesp/go-calendly/calendly\"\u003e\n\u003cimg src=\"https://godoc.org/github.com/theodesp/go-calendly/calendly?status.svg\" alt=\"GoDoc\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://opensource.org/licenses/Apache-2.0\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/License-Apache%202.0-blue.svg\" alt=\"License\"/\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://travis-ci.org/theodesp/go-calendly\" rel=\"nofollow\"\u003e\n\u003cimg src=\"https://travis-ci.org/theodesp/go-calendly.svg?branch=master\" /\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://ci.appveyor.com/project/theodesp/go-calendly\" rel=\"nofollow\"\u003e\n\u003cimg src=\"https://ci.appveyor.com/api/projects/status/ytwi6bn3ai6tmd7i/branch/master?svg=true\" /\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://codecov.io/gh/theodesp/go-calendly\"\u003e\n  \u003cimg src=\"https://codecov.io/gh/theodesp/go-calendly/branch/master/graph/badge.svg\" /\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://goreportcard.com/report/github.com/theodesp/go-calendly\"\u003e\n  \u003cimg src=\"https://goreportcard.com/badge/github.com/theodesp/go-calendly\" /\u003e\n\u003c/a\u003e\n\ngo-calendly is a Go client library for accessing the [Calendly API v1](https://developer.calendly.com/docs/getting-started).\n\ngo-calendly requires Go version 1.8 or greater.\n\n## Usage ##\n\n```go\nimport \"github.com/theodesp/go-calendly/calendly\"\n```\n\nConstruct a new Calendly client, then use the various services on the client to\naccess different parts of the Calendly API. For example:\n\n```go\nclient := calendly.NewClient(nil)\n\n// list all event types for current user\neventTypes, _, err := client.EventTypes.List(context.Background(), nil)\n\n```\n\nSome API methods have optional parameters that can be passed. For example:\n\n```go\nclient := calendly.NewClient(nil)\n\n// list all event types for current user including the owner data\nopt := \u0026calendly.EventTypesOpts{Include: calendly.IncludeTypeOwner}\neventTypes, _, err := client.EventTypes.List(context.Background(), opt)\n```\n\nNOTE: Using the [context](https://godoc.org/context) package, one can easily\npass cancelation signals and deadlines to various services of the client for\nhandling a request. In case there is no context available, then `context.Background()`\ncan be used as a starting point.\n\nFor more sample code snippets, head over to the\n[examples](https://github.com/theodesp/go-calendly/tree/master/examples) directory.\n\n### Authentication ###\n\nThe go-calendly library does not directly handle authentication. Instead, when\ncreating a new client, pass an `http.Client` that can handle authentication for\nyou. If you have an API access token (for example, a [integrations](https://calendly.com/integrations)), you can use it with the library using:\n\n```go\nfunc main() {\n\tctx := context.Background()\n\t// NewTokenAuthClient adds X-Token auth header\n\tauthClient := calendly.NewTokenAuthClient(\u0026calendly.Config{ApiKey: apiKey})\n\tclient := calendly.NewClient(authClient)\n\tresp, _, _ := client.Echo(ctx)\n    \n\tfmt.Println(resp)\n}\n```\n\n\n### API docs ###\n\nFor complete usage of go-calendly, see the full [package docs](https://godoc.org/github.com/theodesp/go-calendly/calendly)\n\n[Calendly API]: https://developer.calendly.com/docs/getting-started\n\n**API Coverage**\n- [x] Event Types\n- [x] User info\n- [x] Webhooks\n\n## Roadmap ##\n\n[Contributing](./CONTRIBUTING)\n\n## Versioning ##\n\nIn general, go-calendly follows [semver](https://semver.org/) as closely as we\ncan for tagging releases of the package. For self-contained libraries, the\napplication of semantic versioning is relatively straightforward and generally\nunderstood. But because go-calendly is a client library for the Calendly API, which\nitself changes behavior, and because we are typically pretty aggressive about\nimplementing preview features of the Calendly API, we've adopted the following\nversioning policy:\n\n* We increment the **major version** with any incompatible change to\n\tnon-preview functionality, including changes to the exported Go API surface\n\tor behavior of the API.\n* We increment the **minor version** with any backwards-compatible changes to\n\tfunctionality, as well as any changes to preview functionality in the Calendly\n\tAPI.\n* We increment the **patch version** with any backwards-compatible bug fixes.\n\nPreview functionality may take the form of entire methods or simply additional\ndata returned from an otherwise non-preview method. Refer to the Calendly API\ndocumentation for details on preview functionality.\n\n## License ##\n\nThis library is distributed under the Apache license found in the [LICENSE](./LICENSE)\nfile.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheodesp%2Fgo-calendly","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheodesp%2Fgo-calendly","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheodesp%2Fgo-calendly/lists"}