Sending and Receiving Fax

---slug: /guides/fax/first-steps-with-faxsidebar_position: 0---# Sending and Receiving FaxIts easy to start sending and receiving Fax using SignalWires APIs! You will need at least one number to send and receive faxes, so if you dont have one already, please follow the instructions below.## Obtaining and configuring a number[Log in](https://signalwire.com/signin) to your SignalWire Space. From the Phone Numbers section, you can [buy a new phone number](guides/numbers-api/getting-started/buying-a-phone-number/index.mdx).## Receiving your first faxThere are two parts to receiving a fax:1. A SignalWire Phone Number;2. The instructions to actually receive the Fax.After you have acquired a number, or in case you have one already, open its settings by clicking on Edit Settings. Scroll down until you reach Voice and Fax Settings, as shown in the next figure, and configure it to:- ACCEPT INCOMING CALLS AS -> Fax- HANDLE FAXES USING -> LaML Webhooks

### Setting up the instructions to receive faxes#### Using XML BinsXML Bins (also called LaML Bins) allow you to tell SignalWire how to handle calls, messages, or faxes by using instructions called Verbs. You can learn more about XML Bins on [this article](guides/numbers-api/guides/general/creating-and-using-xml-bins/index.mdx), but essentially we need to create a new Bin in the LaML section of the Dashboard with the following instructions:xml Lastly, we need to connect the phone number with the instructions to receive the fax, so we copy the Bins URL from the XML Bins section of the Dashboard and paste it in the phone numbers WHEN A FAX COMES IN field, like this:

Thats it! You can now start receiving faxes on your phone number, and they will appear under LaML -> Faxes in your Dashboard:

#### Using Compatibility SDKsIf you wish to avoid using SignalWires XML Bins, you can use our SDKs and host the instructions yourself. Please see our [ Verb instructions](pathname:///compatibility-api/xml/fax/receive#receive-a-fax) for specific code examples.Youll then need to make your code accessible to SignalWire through a Webhook. We have a great [guide on how to do this using ngrok](guides/administration/guides/technical-troubleshooting/how-to-test-webhooks-with-ngrok/index.mdx)!## Sending your first faxThere are three parts to sending a fax:1. A SignalWire Phone Number;2. The destination number;3. The publicly available media to be sent, such as a PDF file.### Using our REST APIUsing our [Send a Fax endpoint](pathname:///compatibility-api/rest/send-a-fax) you can make a POST request tohttps://**YOUR_SPACE_URL**.signalwire.com/api/laml/2010-04-01/Accounts/**YOUR_PROJECT_ID**/Faxeswith the following body parameters:- From- To- MediaUrl### Using Compatibility SDKsYou can send faxes using [our SDKs Send a Fax function](https://docs.signalwire.com/reference/compatibility-sdks/v3/?javascript#api-reference-faxes-send-a-fax), in multiple languages:import Tabs from @theme/Tabs;import TabItem from @theme/TabItem;javascriptconst { RestClient } = require(@signalwire/compatibility-api)const client = RestClient(YourProjectID, YourAuthToken, { signalwireSpaceUrl: example.signalwire.com })client.fax.faxes.create({ from: +13103383454, to: +13104456789, mediaUrl: https://example.com/fax.pdf}).then(fax => console.log(fax.sid)).done();pythonfrom signalwire.rest import Client as signalwire_clientclient = signalwire_client(YourProjectID, YourAuthToken, signalwire_space_url = example.signalwire.com)fax = client.fax.faxes \ .create( from_=+13103383454, to=+13104456789, media_url=https://example.com/fax.pdf )print(fax.sid)csharpusing System;using System.Collections.Generic;using Twilio;using Twilio.Rest.Fax.V1;class Program{ static void Main(string[] args){ TwilioClient.Init(YourProjectID, YourAuthToken, new Dictionary { [signalwireSpaceUrl] = .signalwire.com }); var fax = FaxResource.Create( from: +13103383454, to: +13104456789, mediaUrl: new Uri(https://example.com/fax.pdf) ); Console.WriteLine(fax.Sid);}}php example.signalwire.com)); $fax = $client->fax->v1->faxes ->create(+13104456789, // to https://example.com/fax.pdf, // mediaUrl array(from => +13103383454) ); print($fax->sid);?>rubyrequire signalwire/sdk@client = Signalwire::REST::Client.new YourProjectID, YourAuthToken, signalwire_space_url: example.signalwire.comfax = @client.fax.faxes.create( from: +13103383454, to: +13104456789, media_url: https://example.com/fax.pdf)puts fax.sid## Next stepsCongratulations! You can now send and receive faxes using SignalWire. You are now ready to explore the advanced guides in the Fax section from the left menu.