A simple, dependency-free Go client for the Twilio programmatic fax API.
fox seeks to implement all the functions associated with Twilio's "Faxes" endpoint, but to keep the library tight, does not facilitate, for example, E.164 phone number parsing and validation, or handling Twilio status callbacks.
To get started, construct a new Client with your Twilio account SID and auth token:
c := fox.NewClient("YOUR_TWILIO_ACCOUNT_SID", "YOUR_TWILIO_AUTH_TOKEN")Optionally, you can also pass a pointer to a SendOptions object to NewClient to specify custom
send options (to, for example, tell Twilio not to store fax media):
opts := SendOpts{StoreMedia: false}
c := fox.NewClient("YOUR_TWILIO_ACCOUNT_SID", "YOUR_TWILIO_AUTH_TOKEN", &opts)The Cancel, Delete, Get, List and Send methods on the returned Client are used to make the API calls as described by Twilio's API reference. For example, to retrieve a fax's data by its SID:
res, _ := c.Get("FXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")- ✅ Get a fax instance by its SID
- ✅ List all faxes instances in an account
- ✅ Send a fax
- ✅ Cancel (update) a fax by its SID
- ✅ Delete a fax instance by its SID
- ❌ Get a fax's media resource by its SID
- ❌ List all fax media resources in an account
First, grab the testify package:
go get -u github.com/stretchr/testify
Then, run the tests (the -v flag specifies verbose output):
go test -v