Protocol might be something like this:
>>> hyperlink = paragraph.add_hyperlink(text='foobar', url='http://github.com')
>>> hyperlink
<docx.text.Hyperlink instance at 0xdeadbeef1>
>>> hyperlink.url
'http://github.com'
>>> hyperlink.text
'foobar'
XML specimen:
<w:p>
<w:r>
<w:t xml:space="preserve">This sentence has a </w:t>
</w:r>
<w:hyperlink r:id="rId5" w:history="1">
<w:r>
<w:rPr>
<w:rStyle w:val="Hyperlink"/>
</w:rPr>
<w:t>hyperlink</w:t>
</w:r>
</w:hyperlink>
<w:r>
<w:t xml:space="preserve"> in it.</w:t>
</w:r>
</w:p>
Protocol might be something like this:
XML specimen: